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LEGO DACTA Control Lab Reference Guide 


The LEGO DACTA Control Lab Reference Guide is a complete, in-depth source 
of information on all the Control Lab primitives, as well as a guide to the more 
technical aspects of Control Lab. 

The manual is divided into three sections: 

Section 1: Using LEGO DACTA Control Lab 

This section provides general information on the Control Lab project 
environment: pages, boxes, buttons, tools, menus and help. 

Section 2: LEGO DACTA Control Lab Primitives 

This section consists of a description of each Control Lab primitive, in 

alphabetical order, accompanied by an example of its use. 

Section 3: Appendices 

This section includes a complete listing of the primitives by function, a list of 
pre-defined shapes, an explanation about creating variables, a description of 
the error messages and a glossary. 
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Section 1: Using LEGO DflCTfl Control Lab 


The Control Lab software is a computer environment for controlling LEGO 
DACTA 9 volt models. 

With Control Lab, you can: 

• Write procedures to control the movement of the models. 

• Collect and display feedback from the various sensors. 

• Create and print reports integrating pictures, text and procedures. 

• Create computer presentations for class reports and projects. 


Description 

In Control Lab you create and work with projects which resemble binders with 
pages on which you can place passive and active elements like text, graphs, 
pictures and buttons. You can make guided tours through your project and 
you can build your own control panels or other graphical user interfaces for 
other people to use. You can even create tools and import graphics or text for 
your project. 

Control Lab projects are like ring binders with inserted pages. When you create 
a new project it consist of only three pages: A Setup page, a Procedures page 
and a project page. 

The Setup page shows an image of the LEGO DACTA Serial Interface and is 
used for direct control of LEGO® models as well as for documentation and 
experiments (see pages 1.11-1.20). 

The Procedures page is used for writing Logo procedures. 

The project page is used for setting up your own project using text, pictures, 
buttons, graphs, monitors and sliders. You can make your own user interface to 
the program, and a project can have any number of project pages. 

The software provides multitasking facilities, and it thus enables you to run 
several processes at the same time. 

Control Lab consists of a menuline and four different windows: 


Project Window 

The project window shows the current page of your project (see page 1.21). 

It cannot be resized, but when the Procedures page is current, the window has 
scroll bars. 









Command Center 


The Command Center is used for typing and executing Logo commands and 
for displaying text and error messages. The Command Center floats on top of 
the Project Window. 

Tools Palette 

The Tools Palette is only present when a project page is current in the Project 
Window. It is used for generating project page elements such as text boxes, 
graphs and buttons. 

Help Window 

The Help Window is used for displaying help on project elements, error mes¬ 
sages and on the Logo language. It appears when help is selected. 

Starting Up 


There are three types of files referring to LEGO DACTA® Control Lab: 


Filename (MS-DOS) 


ctrlab.com 


<name>.clb 


<name>.txt 


Double click on the Program icon, or select it and choose Open from the File 
menu to start Control Lab. Opening a project file or a text file also loads the file 
after starting the application. 

On MS-DOS machines 

At the prompt in the Control Lab directory type ctrlab and Enter. To start up 
with an open project file type ctrlab <proj ectfile> and press Enter. 


Type of file Icon (Macintosh) 


Program file 


Project file 


Text file 


On the Macintosh 
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When LEGO DACTA® Control Lab starts, the Startup Screen is displayed: 



When you click the mouse button or press Return or wait a while, the 
Command Center and the Menu line appear. 

Menus 




About... 

Shows the Startup screen. Click on the Startup screen to go back to your project. 




























































The File Menu 


File 


New Project 

&N 

Open Project... 

:#:0 

Close Project 

9§UI 

Saue Project 

&S 

Saue Rs... 

_ 

Preferences 

Printer Setup... 


Print Project 

38P 

Print Page 


Quit 

m 


New Project 

Opens a new project. It is only possible to have one project open at a time. 

Open Project 

Opens a dialog box displaying projects and folders. It is only possible to have 
one project open at a time. 

Close Project 

Closes the current project, saving it if desired. 

Save Project 

Saves the current project. If the project has no name, the Save dialog box opens. 

Save As... 

Opens the Save dialog box. 

Preferences 

Sets global parameters for Control Lab (communication port, decimal 
delimiter). The parameters are saved on disk. 

Printer Setup... 

Opens a window where printer parameters can be set up. Before using the 
printer the first time in a Control Lab session, it is a good idea to do the printer 
setup. 
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Print Project 

Prints all the pages in the current project.The Procedures page is printed in full, 
including the text that has scrolled. Other pages are printed as they appear on 
the screen. 

Print Page 

Prints the current page. The Procedures page is printed in full, including the 
text that has scrolled. Other pages are printed as they appear on the screen. 

Quit 

Closes and, if changes have been made, saves the current project and quits 
Control Lab. 


The Edit Menu 


Edit Wm, 


Undo Tent 


Cut 


Copy 

sec 

Paste 

m 

Clear 
Select Rll 

#:fi 

Search 

Replace 

Stopall 



Undo Text 

Restores the latest deleted text. 

Cut 

Removes the selected item and stores a copy in the Clipboard. The item can be 
text or page elements. 

Copy 

Puts a copy of the selected item in the Clipboard. 

Paste 

Places the item that is stored in the Clipboard onto the page. If the item is text, it 
is pasted at the cursor position. If necessary, new names are given to pasted 
elements since two page elements (e.g., text box or slider) cannot have the same 
name within a project. 














Clear 

Clears the selected item on the page. 

Select All 

Selects all the page elements. If a cursor is flashing, Select All selects in that area. 

Search 

Opens the dialog box for searching a specific character string in the current 
Text box or on the Procedures page if it is showing. Before using Search, click in 
the Text box or on the Procedures page to set a starting position. 

Replace 

Brings up a dialog box to replace a character string in the current Text box or on 
the Procedures page if it is showing. 

Stopall 

Stops all running procedures and processes, including button-generated 
activities and sampling graph boxes, turns off all outputs and returns control 
directly to the Command Center. The monitors remain active. 


The Pages Menu 


Pages 


Neiu Page 

Setup 

331 

Procedures 

3S2 

Pagel 

3§3 


New Page 

Opens a new page in the current project. 

Setup 

Selects the Setup page. 

Procedures 

Selects the Procedures page. 

Pages 

Choosing a page name displays that page. Pagel, Page2, and so on are default 
names. Pages can be renamed. See namepage in Section 2, Listing of 
Primitives. 
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The Windows Menu 


Windows 


'Z Tools Palette 88 T 
sZ Command Center 98 D 


Tools Palette 

Toggles between making the Tools Palette visible and invisible. 

Command Center 

Toggles between making the Command Center visible and invisible. 


The Help Menu 


Help 


Primitiues 

Errors 

General 


Primitives 

Displays a window of all the Control Lab primitives. Select a primitive name to 
get a corresponding definition and an example. 

Errors 

Displays a window of error messages. Clicking on an error message brings up a 
corresponding explanation. 

General 

Displays a window listing 
key topics such as the page 
elements, the sensors and 
the Setup page. Select a 
topic to get more 
information. 



When you select help from the menu line, using 3€-? (Macintosh) or Alt-H (MS- 
DOS), a window appears. Use the arrow keys, the first letter of the item name or 
the mouse to select the item about which you need information. 









































A LEGO DACTA® Control Lab Project 


You can create a new project (New Project in the File menu) or open an existing 
one (Open Project in the File menu). 

A project consists of: 

• One Setup page for direct control and setting up the software with the 
interface box. 

• One Procedures page where programs are written. 

• A number of project pages for running an experiment and writing a report. 

Note: There can be only one Control Lab project open at a time. 

In the following sections the different page types are described. 


Setup Page 

The Setup page is a graphical representation of the LEGO DACTA Serial 
Interface. 


3— 13 




| Temp | 

.nn. 


1 Touch 1 

m 


1 Light | 

L jh mu 


Q 


Pi m 


Angle | 


The Setup page can be used to: 




• Designate the type of element (motor, lamp, sound element) connected to the 
output ports. 


• Designate the type of sensor (temperature, light, touch, angle) connected to 
the input ports. 
















































































• Rename sensors, motors, lamps and sound elements. 

• Activate motors, lamps and sound elements using the mouse. 

• Show the values reported by the sensors. 

• Setup a link between a motor and an angle sensor. 

• Give instructions to the touch sensor. 

To connect a Setup page element, drag its icon from the palette and drop it on a 
port.Valid ports are highlighted when dragging over them. Once an element is 
connected to a port, its characteristics can be edited in its corresponding dialog 
box. To open the dialog box of a connected element, double-click on its icon 
(on the port, not on the right or left palette). 


Motors, Lamps, and Sound elements 

Icons of motors, lamps, and sound elements can be connected to any of the 
eight output ports or to the constant output port. 



The two circles above the ports can be used to activate the motor, lamp or 
sound element connected to the output port. 


When one of these icons is connected on the Setup page, the port takes a new 
shape and a default name (the type of element plus a letter; e.g., mot ora). That 
name can then be used to designate the port. 


To remove an icon from a port, simply drag it from the port to a region of the 
screen where there are no ports. 






















































































































































Motor 

To open a dialog box for a motor, simply double¬ 
click on the motor icon placed on the Setup page 
output port (e.g. mot ora). 

The motor can be activated by clicking on the two 
circles above its icon. While doing so, the onf or 
timer displays the time the mouse has been pressed. 
You can then use this value in your programs. Click on the stopwatch to reset 
the onf or timer. 






Modify Motor 



Name Motors is the default name of the motor connected to output 

port A. 

Leftname The Leftname line is used to give a meaningful name to the left 
direction of the motor; for example, Forward. 

Rightname The Rightname line is used to give a meaningful name to the 
right direction of the motor; for example, Backward. 

The motor can be related to a sensor instead of time. For example, if an angle 
sensor is in the mechanical path of a motor, the motor can be set to run until 
the sensor reaches a given value. Here is a typical sequence of operations to 
link a motor and a sensor: 

• Build a LEGO® model with an angle sensor in the mechanical path of a motor 
(the angle sensor rotates from the action of the motor). 

• On the Setup page, connect the angle sensor to one of the blue input ports (5 
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to 8). Connect the motor to one of the output ports (A to H) and double-click on 
the motor icon to open its dialog box. 


• Click on the arrows at the right-hand side of the stopwatch to select the angle 
sensor. 


O O 

motora 



0 



angle5 


• Click on one of the two circles above the Motor icon 
to see how the numbers increase and decrease. Now 
onf or is related to the movement of the angle sensor. 


Lamp 



To open a dialog box for the lamp, simply double-click on the lamp 
icon placed on the Setup page output port. 


The lamp can be activated by clicking on the two circles above its icon. While 
doing so, the onf or timer displays the duration of the mouse click. You can 
then use this value in your programs. Click on the stopwatch to reset the onf or 
timer. 


Modify Lamp 


m 


| lampb 

n 

iMBin—Mill 



mmmmmmm i 

IBB 

u 


Name: 

Leftname: 

Rightname: 


Enperiment 

o o 




larnpb 


Stop-watch 


Help 


Cancel 


GD 


Name Lampb is the default name of the lamp connected to output 

port B. 

Leftname The Leftname line can be used to give a meaningful name to 

other types of lamps from the LEGO® assortment. 

Rightname The Rightname line can be used to give a meaningful name to 
other types of lamps from the LEGO assortment. 

































































Sound element 



To open a dialog box for the sound element, simply double-click 
on the sound element icon placed on the Setup page output port. 


The sound element can be activated by clicking on the two circles above its 
icon. While doing so, the onf or timer displays the duration of the sound. You 
can then use this value in your programs. Click on the stopwatch to reset the 
onf or timer. 


Modify Sound Unit @ 



Name 

Soundc is the default name of the Sound element connected to 
output port C. 

Leftname 

The Leftname line can be used to give a meaningful name to one 
of the two different sounds that the sound element can make; for 
example Beep. 

Rightname 

The Rightname line can be used to give a meaningful name to 
one of the two different sounds that the sound element can 
make; for example Beep-Beep. 
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Sensors 

; Sensors include temperature, touch, light, and angle sensors. The temperature 
; and touch sensor icons can be dragged and dropped over the input ports 1,2,3, 
; or 4. The angle and light sensor icons can be dragged over the input ports 5,6, 

: 7, or 8. Actually, there is a color code to the connections: yellow sensors go on 
; yellow ports and blue sensors go on blue ports (on a monochrome screen, dark 
. go with dark and light go with light). 

When the icon of a sensor is placed on a port, the port takes the shape of the 
sensor and a default name (the type of sensor plus the number of the port; e.g., 

: tempi), and the value for that sensor is displayed and updated immediately 
The port name can be used to report the value read by the sensor. 



Example: 

show tempi 

24 

show touch2 

true 

if touch2 [show "II am touched!I] 

I am touched! 















































































































































Temperature Sensor 



To open a dialog box for the temperature sensor, simply 
double-click on the temperature sensor icon placed on 
the input port. 


K^nrlifu Tomnorstnrp ^pntnr 

,nnn 

(HE 

1 ' IUUI 1 |Lj 1 *_• ■ ■ I |_F *_■ ■ U 1UI W VII V Wl 



i 

Name: 

| tempi 


20 


Measure: 

Celsius 




Rdjust: 

0 © 

tempi 


Help 

| Cancel 

C 

OK 

i 


Name Temp 1 is the default name of the Temperature sensor connected 

to input port 1. 

Measure Click and hold down the Measure popup menu to set the sensor 
mode to Celsius or Fahrenheit. 

Adjust Click the arrows to Adjust the temperature reading. 


The current value read by the sensor is constantly displayed and updated both 
on the Setup page and in the sensor dialog box. 
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Touch Sensor 



To open a dialog box for the touch sensor, simply double¬ 
click on the touch sensor icon placed on the Setup page 
input port. 


Modify Touch Sensor 


Name: 

Measure: 


touch2 


boolean 

Reset Sensor 


Rction: | Modify True 

[ Modify False 


P0?l 


true 


n n 



touch2 


Help 


Cancel 


GO 


Name Touch2 is the default name of the touch sensor connected to 

input port 2. 

Measure Click and hold down the Measure popup menu to set the sensor 

mode to select boolean (true/false) or counter mode.The counter 
is incremented by one unit each time the sensor is pressed. 

Action Click in Modify True to set the instruction that should be run 
once each time the sensor is pressed. 

Click in Modify False to set the instruction that should be run 
once each time the sensor is released. 


Example: 

In Modify True, write: t to "motora on 
In Modify False write :tto "motora off 

Now a motor placed on output port A will run when the touch sensor is pressed 
and stop when it is released again. 

The current value read by the sensor is constantly displayed and updated both 
on the Setup page and in the sensor dialog box. 
































































Light Sensor 



To open a dialog box for the light sensor simply double-click 
on the light sensor icon placed on the Setup page input port. 


Modify Light Sensor 



Name: 

Measure: 

Adjust: 


lights 


Percent | 



o 



lights 


Help 


Cancel 


t 0K - 1 


Name Light 5 is the default name of the light sensor connected to 

input port 5. 

Measure Click and hold down the Measure popup menu to set the sensor 

mode.Select Percent mode (numbers between 0 and 100) or Raw 
mode (numbers between 0 and 1023). In Percent and Raw mode 
the measurement shown indicates the light measured. See 

boolean. 

Adjust Click the arrows to Adjust the light reading in percent mode. 

The current value read by the sensor is constantly displayed and updated both 
on the Setup page and in the sensor dialog box. 
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Angle Sensor 



To open a dialog box for the angle sensor simply double-click 
on the angle sensor icon on the Setup page input port. 


Modify Angle Sensor 


Name: 

Measure: 


angle6 


rotation 

Reset Sensor 



o 



angle6 


Help 


Cancel 


OK 


J 


Name Angle6 is the default name of the angle sensor connected to 

input port 6. 

Measure Click and hold down the Measure popup menu to designate the 

type of reading the sensor should perform (Angle or Rotation). 
The sensor reports the rotation registered since it was last reset. In 
the Angle mode, the value is reported in degrees, by resolution of 
22.5 degree (rounded value of 1 / 16th of 360 degrees). In the 
Rotation mode, the value is 16 per full rotation. 

Reset Sensor Click Reset Sensor to reset the angle sensor to zero. 

The current value read by the sensor is constantly displayed and updated both 

on the Setup page and in the sensor dialog box. 






































































Procedures Page 


The Procedures page is used for writing LEGO DACTA® Control Lab 
procedures. The Procedures page is saved as part of the project. The contents 
of the Procedures page can be saved separately using the save text command. 
See savetext, loadtext, loadprocs, and loadtools. 

Semicolons (;) can be used to insert comments in procedures. 

to test 

; Connect the motor to output port A before running 
tto "motora 
onfor 30 
end 

Project Pages 


w File Edit Pages Windows Help (£) ^ 



You can only see one page at a time on the screen although you may have 
several pages in a project. Use the Pages menu to go from page to page or to 
add a new page to the project. See The Pages Menu, page 1.9. 

Pages are automatically named when they are created, but you can give them 
your own names. A project can be moved around by dragging its title bar. It 

1.21 
















































cannot be resized or scrolled. A page cannot be saved individually: it is saved as 
part of the project. Clicking on the Close box of a page closes the whole project. 

Project pages can have the following kinds of elements: 


Tool 

Page element 

Used to 

§ n mm 



JA. 

Graph 

Plot sensor inputs or show contents of 
numerical lists. 

ZTJLU 

Text 

Write text in a text box on a project page. 

r .A-- 

LJ 

Picture 

Place graphics on the Project Pages. 

2io 

1=1 ri 

Monitor 

Display values (e. g. variables, sliders, sensor 
inputs). 

B< 

1 B 

Button 

Execute instructions (e. g. turn on motors, 
run procedures). 

|=I=| 

Slider 

Set numerical values within a range (e. g. 
motor power, variables). 


Creating and Deleting Page Elements 

Page elements can be created using the mouse, or the create command (see 
the Listing of Primitives in Section 2.) 

To create a page element, click on the icon of your choice in the Tools Palette, 
and click on or drag across a region of the page. 

When a page element is created, a default name is assigned to it. The default 
name is the type of the element followed by a number. The name and other 
characteristics can be edited in the corresponding dialog box or by using the 
commands setname, setfont, setstyle, etc. 

To delete a page element, do one of the following: 

• Select it and press the Delete key. 

• Select it and use the cut keys to store the element in the Clipboard, available 
for pasting. 

• Use the remove command. 












































Mouse Action 



HowTo 

Activate an element. Click on unselected element; e.g., click on 

a button to trigger its instruction, click 
on a text box to activate the cursor in the 
text box. 

Select the element. Drag around elements or shift-click on 

elements. The area must include at least one 
border of the element. 


Select or unselect many Shift-click on elements, shift-click-drag or 

elements. K -A (Macintosh) or Alt-A (MS-DOS). 


Open the dialog box of an Double-click on a selected element or shift- 

element. double-click on an element. 


Relocate an element. 


Shift-drag an element or simply drag the 
selected element. 


Resize an element. Drag a black handle on a selected element. 

If the handles are gray, the element can not 
be resized. 

Get Help information about a Choose General in the Help menu to select 
specific element. the page element, click Help in the element 

dialog box or use $£-? (Macintosh) or Alt-H 
(MS-DOS). 


Overlapping ol Page Elements 

Page elements can be placed anywhere on the page. Whenever a large page 
element completely overlaps a smaller one, the smaller one is placed on top of 
the larger one. 


Button1 



slider 1 


textl 
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If the smaller page element is partially overlapped, it becomes only partially 
visible. 


■ 

■ 

Button1 

■-I T.- 

inn 

slider 1 

■ 


textl 


To make the smaller page element completely visible, simply select it by 
holding down the Shift key and clicking on the element. 



■ 

Button1 


\M 


slider 1 


textl 


If you want to relocate many page elements, select all the elements, then drag 
one of them to a new location. All the selected elements will follow. 


Graph Boxes 

A graph box is used to plot the input of a sensor or a curve representing data. 

Creating a Graph Box 

To create a graph box, click on the Graph Tool and click or drag a region on the 
Project page. Once a graph box is created, it can be selected, moved, resized, 
cut, copied, or deleted. There can be multiple graph boxes on a page but a 
maximum of four can be active at a time. 

























Click on the Startsample/Stopsample icon (bottom, left) to start and stop the 
sampling process.To start a graph, one of the sensors shown in the graph dialog 
box (Sample 1-4) must be selected. 

Using a Graph Box 

When you double-click on a selected graph box, the dialog box for the graph 
box appears: 


Macintosh dialog box 


Modify Graph 


Name: 


graph 1 


Boh: 0 Shorn Name Color: |^|| | | 

M Show Frame 


Sample: 1— 


Internal: 


L 


None 




None 



10 


L 


None 


None 



Points: g] Highlight 0 Connect 


( Help ) 


Cancel 


LjlJ 
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MS-DOS dialog box 


Modify Graph 




Mane: 



^ Show Name 


Box: S Show Frane 


Color: 

IB 




Color 


Color 



Following is a description of the items found in a graph dialog box. 

Name Graphl is the default name of the graph box. 

Show Name When activated (box is checked), the name is displayed below the 
graph box. 

Show Frame When activated (box is checked), the frame is displayed around 
the graph box. 

Sample The Sample Popup menus containing the icons and names of the 

sensors that are connected on the Setup page. 

Interval The interval, in tenths of a second, between samples. The 

equivalent command is set interval. 

Highlight When activated (box is checked), highlights the points on the 

graph, if they are more than 4 pixels (screen points) apart. 

Connect When activated (box is checked), points are connected on the 
graph. 

Color Displays the color allowing you to set the color of the background 

and the axes. 





























































































Setting a Graph tor Sampling 

To plot the values read at a sensor, you first have to connect the sensors on the 
Setup page. Only these sensors are available in the Sample popup menus. 

Click on any Sample popup menu to choose one of the sensors. The maximum 
number of samples in a curve are 3000. 

Other Graph Parameters 

Clicking once on the image of a graph in the graph dialog box opens a second 
box allowing you to set some display parameters and some functional 
parameters. 


Modify Graph 1 L 


Y-Label: 

Y-Man: 

Y-Min: 

y 

Boh: ^ Shorn Scales [x] Shorn Labels 


1023 

y 

1023 

o 



0 

1 

0 200 

X 


graph 1 

H-Label: 

« 

Help Cancel 

LsJ 

1 


Y-Label 
Y-Max 
Y-Min 
X-Label 
Show Scales 
Show Labels 


Y is the default name of Y-axis. 

The Y-max is as default set to 1023. 

The Y-min is as default set to 0. 

X is the default name of the X-axis. 

When activated (box is checked), the scales are shown. 
When activated (box is checked),the labels are shown. 
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: The display parameters relate to displaying the x and y axes, the scales and the 
labels. 

The other parameters are the limit values on the y axis. This is a way to preset 
the size of the y axis. After a sampling is done, the y axis can still be adjusted 
: with the zoom-in tool or in the graph dialog box. 

Zooming in the Graph Box 

• Once a graph has a curve, a smaller area of the graph can be selected (“zooming 
: in”). Drag a rectangle to define the area to be enlarged. 

The x and y axes are rescaled to represent 
the smaller defined area in a graph box of 
the same size. 
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graph1 



Clicking on the zoom-out magnifying 
glass returns to the full graph 
representation. Clicking on the grabber 
hand allows you to move the region that is 
currently magnified. Clicking on the 
scissors cuts this portion of the graph and 
makes it the current full-size graph. This 
feature can be used to rescale the graph 
and eliminate irrelevant data. 


Curve Reader 

• A curve reader shows, for any x value, the vertical coordinate corresponding to 

• each curve on the graph. To get the curve reader, click anywhere inside the 

• graph area defined by the axes. 





























graphl 


Text Boxes 

A text box is where text is typed. 


Click on the 
right arrow to 
make the arm 
turn clockwise. 


text 1 

To create a text box, click on the Text tool and click or drag a region on the 
project page. Once a text box is created, it can be selected, moved around, 
resized, cut, copied, or deleted. You can type direcdy in a text box or use 
commands (print, insert) to display information. There can be multiple 
text boxes on a page. 

A text box can contain only one font, size, and color, but each text box on a 
page can have a different font, size, and color. These characteristics can be 
edited in a dialog box. The dialog box for a text box appears on the screen when 
you double-click on a selected text box. 
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Macintosh dialog box 


Modify Tent 


Name: 

Font: 

Size: 

Style: 


tentl 


Monaco 



] Bold 

□ ftatic 

□ Underline 

□ EfflGOQm© 

□ QftEaSltDtm 


Help 



Boh: 

Color: 


0 Shorn Name 
0 Shorn Frame 



□ 


Text 


text 1 


Cancel 


GO 


MS-DOS dialog box 


Modify Text 




Name: 


Box: 


Show Name 
Show Frame 


Color: 

■■ 





Color 


Color 






Text 

textl 

Help Cancel 

OK 




Name Text 1 is the default name of the text box. 

Show Name When activated (box is checked), the name is displayed below 
the text box. 






































































































Show Frame When activated (box is checked), the frame is displayed around 
the text box. 

Font The popup menu shows the different fonts. Macintosh only! 

Size Sets the font size. Macintosh only! 

Style When activated (box is checked), the style is set. Macintosh only! 

Color Display the color allowing you to set the text and background 

color. 


Text in the text box can be cut or copied, then pasted into another text box, the 
Command Center, or the Procedures Page. The text box itself can be cut or 
copied once it is selected. Pasting will create a new text box with the same text 
in it. 

The contents of a text box (including the words that have scrolled away) can be 
printed using the printtext command. If there are many text boxes on the 
page, click one first to make it the current element of its type. 

The text box name can be used to report its contents as a word. If a text box 
named textl contains the sentence “This is some text,” the following 
instructions would work as follows: 

show textl 

This is some text 

show count textl 

17 

This number includes all the characters and the three spaces. The parse 
primitive can be added to the last instruction to turn the character string into a 
list: 

show parse textl 

[This is some text] 

show count parse textl 

4 
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Picture Boxes 


A picture box is used to hold picture shapes. Picture shapes can be chosen from 
the Shapes popup menu, imported, or created from within Control Lab. 

To create a picture box, click on the Picture tool and then click on or drag across 
a region of the page. A default picture box comes with an empty shape. To select 
a shape, open the dialog box for that picture box by double-clicking a selected 
picture box. Click the arrows or use the popup menu to see a list of picture 
shapes. 


Macintosh dialog box 


Modify Picture 



Name: 

Shape: 


pictl 



Empty Piet... 


[x] Shorn Name 
0 Shorn Frame 

□ Reset Size 



pictl 


Cancel 


OK 













































MS-DOS dialog box 



pictl 


Help 


Cance1 


OK 


Name 

Show Name 

Show Frame 

Shape 
Reset Size 


Pictl is the default name of the picture box. 

When activated (box is checked), the name is displayed below 
the picture box. 

When activated (box is checked), the frame is displayed around 
the picture box. 

The popup menu shows the different picture shapes. 

Reset the size of a resized Picture. Macintosh only! 


There are no functions linked to picture boxes. Invisible buttons can be placed 
over portions of the pictures to make the picture interactive (see the section 
Buttons on page 1.36). 

New shapes can be created by pasting graphics from other applications. This 
creates a new picture box containing the new shape. The name of the shape 
will be the word shape followed by a number. Use renameshape to change its 
name. 
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A shape can also be created or modified using graphics commands. See 

openshape, moveto, lineto, and closeshape. 

User-created shapes always appear in a rectangular frame, hiding the 
background. Original shapes have a frame which is the outline of the shape 
itself. 


Monitor Boxes 

A monitor box is used to display the continually updated value of a variable, a 
sensor, or a slider. 


To create a monitor box, click on the Monitor Tool and then click on or drag 
across a region of the page. 

When a monitor box is created, a default name, size, font and style are assigned 
to it. There is no pre-defined function. The name and other characteristics can 
be edited in a corresponding dialog box. Open the dialog box for a monitor box 
by double-clicking on a selected monitor box. 


Macintosh dialog box 



Modify Monitor 


Name: 


monitor 1 


E Shorn Name 


Font: 

heluetica 

Boh: ^ Shorn Frame 

Size: 

12 


Color: 

Style: 
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Italic 
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Help 
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Cancel 







































































MS-DOS dialog box 


Modify Monitor 


21°1 


Name: 


onitorl 


Box: 

3 Show Name 


3 Show Frame 

Color: 

Colorl Icolorl 

Monitor 


monitorl 


Report: 
Monitor: 


Round 

Active 


Show : 


f(x) 


Function... 





Help Cancel 

OK 





Name 
Show Name 

Show Frame 

Font 

Size 

Style 

Color 


Monitorl is the default name of the monitor box. 

When activated (box is checked), the name is displayed below 
the monitor box. 

When activated (box is checked), the frame is displayed around 
the monitor box. 

The popup menu shows the different fonts. Macintosh only! 

Sets the font size. Macintosh only! 

When activated (box is checked), the style is set. Macintosh only! 

Display the color allowing you to set the text and background 
color. 


Show From the popup menu, sensors connected on the Setup page can 

be selected. To monitor a function, choose F(x) from the popup 
menu. 
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Round When activated (box is checked), the value displayed in the 
monitor box is rounded. 

Activate When activated (box is checked), the monitor box is active. 


If you want to monitor the values read by a sensor, first go to the Setup page to 
connect the sensor (see Setup Page, page 1.11). Then create a monitor and open 
its dialog box. Use the Show popup menu to indicate what the monitor will be 
monitoring. The popup menu has the names of all the connected sensors, plus 
an F(x) option. 

To monitor a function, choose F(x) from the popup menu. A function can be 
the name of a variable or a reporter. 


Modify Monitor Function ffx) 


Function: 



Cancel [ OK ] 



If the function of a monitor box uses an undefined variable (e.g., 2 * temp5, 
the monitor box becomes inactive and an error is reported. Create the variable 
and activate the monitor box from its dialog box (See the primitives activate 
and deactivate in Section 2, Listing of Primitives.) 


Buttons 

A button is an object which can be activated by clicking on it with the mouse. 

To create a button, click on the Button Tool and then click on or drag across a 
region of the page. 

There are two types of buttons: On/Off and On. When you create a button, its 
default mode is On/Off. You can change its mode using the button dialog box. 
Open the button dialog box by double-clicking on a selected button. 

When Show Name is activated (box is checked), the name is displayed below 
the button. 































Button dialog box 


Modify Button 


Name: 

Shape: 

Type: 

Action: 


Buttonl 


3 Shorn Name 
[XI I Default ... 


® On/Off 

O On 


On 

Off 


Buttonl 


Help 


Cancel 


GO 


Name Buttonl is the default name of the default button. 

Show Name When activated (box is checked), the name is displayed below 
the button. When a button is created, it has a default shape 
which shows the name of the button. The default button shape is 
resizable. 

A button in its default shape is invisible when Show Name is not 
activated. Invisible buttons can be placed on top of other 
elements or picture boxes. (See setwallpaper.) 

Shape The popup menu shows the different button shapes. 

Type When the On/Off is chosen, the Action:On instruction is 

activated after the first mouse click and the Action:Off instruction 
after the next click. 

When the On is chosen the Action:On instruction is activated 
when the mouse is pressed. The Action:Off is activated when the 
the mouse is released. 
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Examples of On/Oft button instructions 


Action: On 

go 

Call a procedure with 
the name go 

Action: Off 

stopall 

Stop all running 
procedures 

Action: On 

talkto "motora on 

Turnon motora 

Action: Off 

talkto "motora off 

Turn off motora 


Examples ol On instructions 


Action: On 
Action: Off 


talkto "motora on Turnon motora 
talkto "motora off Turnoff motora 


Sliders 

Sliders can be used to set a numerical value and run a function whenever its 
value is changed. 

To create a slider, click on the Slider Tool and then click on or drag across a 
region of the page. When a slider is created, it has a default shape. To select a 
different shape, open the slider dialog box by double-clicking on a selected 
slider. 


Modify Slider 


1 B 
= 1 = 


Name: 

Shape: 


slider 1 


[X] Show Name 


Standar... 


Direction: 

Report: 


(§) Horizontal 
O Uertical 

0 Round 


Min: 
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Man: 
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Release: 



[ Help | 


[ Cancel 




















































Name 


Sliderl is the default name of the default slider. 


Show Name 

When activated (box is checked), the slider name is displayed 
below the slider. 

Shape 

The popup menu shows the different slider shapes. 

Direction 

Choose Horizontal or Vertical to set the orientation of the slider. 

Round 

When activated (box is checked), the slider reports a rounded 
value. 

Min 

The default minimum number of the slider is zero. 

The minimum number can be a number between -10,000 and 
9,998. 

Max 

The default maximum number of the slider is eight. The 
maximum number can be a number between -10,000 and 10,000 
but the maximum number must always be higher then the 
minimum number. 

Value 

The Value must be a number in the minimum and maximum 
range. 

Release 

The Release instruction is is carried out when the slider is clicked 
and released with the mouse. 


Examples of Release instructions 


Release 

tto "motora setpower sliderl The slider controls the 

speed of motora. 

Release 

setvalue tempi The tempi sensor data 

sets the position of the 


sliderl. 

The slider name can be used to report its current value (e.g. show sliderl). 
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Current Element 

Many LEGO DACTA® Control Lab commands have an effect on the “current” 
element of a given type. A start sample command, for example, will activate 
; the current graph box. 

Other commands have an effect on the most current element of all types. To 
make sure that your commands will address the element of your choice, make 
it current either by clicking on it or by specifying its name in your instruction. 

; For example: 

; talkto "motora 
! on 

; The comma is a shortcut for the talkto command. 

; E.g. motora, on 
text2, ct 

. See talkto in Section 2, Listing of Primitives. 






Section 2: LEGO DACTA Control Lab Primitives 


This section consists of a description of each LEGO DACTA Control Lab 
primitive. Preceding the alphabetical listing of all the primitives are 
explanations about: 

• The way Control Lab performs mathematics. 

• Commands and reporters. 

• How each primitive is described. 

• The input words. 

Mathematics and Syntax 


Spaces must be used to separate the infix math reporters from their inputs. For 
example: 

show 3+3 

I don't know how to 3+3 

show 3+3 

6 

Parentheses must be used to group instructions in order to control the 
sequence in which they are run. For example: 

show 3 + 9*9 9 * 9 is executed first 

84 

show (3 + 3) * 9 3 + 3 is executed first 

54 

show first "hello = "h 

f 

"hello = "h is executed first and reports f alse.Then, first reports the first 
letter of the word false. 

show (first "hello) = "h 
true 

First "hello is executed first and reports "h. This "h is then compared to 
the second "h and = reports true. 

Vertical bars must be used as delimiters when a word contains spaces. They tell 
Control Lab that everything between the bars is just a string of characters: 

show "hello there 

I don't know how to there 

show "I hello there I 
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hello there 

show count "I hello there I 

11 

Commands and Reporters 


There are two types of Control Lab primitives: commands and reporters. 

Commands tell Control Lab to do something. 

Create Tells Control Lab to create a page element. 

Print Tells Control Lab to print in the current text box. 

In any Logo instruction, the first word must be a command. There are two ways 
for a command to get an input: 

• Direcdy, as in 

show "hello 

• Indirecdy, as in 

show pos 

Pos is a reporter. Reporters “report” information—they deliver information 
about something. In this case, pos reports the position of the current project 
page element. Reporters always report their information to a command or to 
another reporter. If you use a reporter by itself, a message appears: 

pos 

I don't know what to do with [20 20] 


How Primitives Are Described 

Each primitive is described in the same way. 

Here is an example of how a primitive is described: 

butfirst word-or-list Reporter/1 input 
bf word-or-list 


Reports all but the first component of a word or list. See butlast, first and last. 











Examples: 

show bf [0123] 

[1 2 3] 

show bf [hello there] 

[there] 

show butfirst butfirst "mypict 

pict 


Description: 

<butfirst> is the primitive name. 

<Reporter> is the type of primitive (command, reporter, or special words). 
< /1 input> is the number of inputs most commonly used. 

<bf> is the short form of butfirst. 

<Reports all but the first component of a word or list> is the definition. 
<Examples:> shows examples of use. 


Here is an example of how the top line of a primitive with more than 
one choice of inputs looks: 


word word-or-listl word-or-list2 Reporter/2 inputs 

(word word-or-listl word-or-list2 word-or-list3...) 

Many inputs when parentheses 
are used. 


Description: 

Shows that any number of inputs can be used. If you use a different number of 
inputs from the number most commonly used, the primitive and its inputs 
must be enclosed in parentheses. 
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Input Words 


On the following pages, you will find an alphabetical listing of the types of 
inputs that Control Lab primitives use. Beside each word is a description of 
what the actual input must be. 


Type of Input 

Real Input 

char 

Letters of the alphabet, numbers, punctuation marks, 
and special characters. 

Example: 

show ascii "a 

97 

curve-number 

A number between 1 and 4 inclusive, corresponding to the 
four curves of graph boxes. 

Example: 

setdata 1 [10 20 30] 

drawing-pos 

X-coordinate and Y-coordinate in a list, representing 
screen coordinates.The position [0 0] is in the top, left 
corner of the current picture box. 

Example: 

moveto [10 10] 

element 

The name of a page element or a Setup page element. 
Example: 

ask "lampb [on] 


input-port-number A number between 1 and 8 inclusive, representing an 
input port, regardless of what is connected to it. 



Example: 

show Celsius 1 

24 

list 

Information enclosed in brackets [ ]. 

Example: 

setdata 1 [20 30 40] 

list-of-numbers 

A list containing an undetermined number of numerical 
values. 

Example: 

show average [5 10 10 5] 

list-to-run 

A list of instructions that Control Lab can run. 

Example: 

setmonitorfunction [speed] 






name 

The name of an existing variable. 

number 

A number between -2147483647 and 2147483647. 

Example: 

wait 50 

page-element 

The name of a graph box, text box, picture box, monitor 
box, slider, or button. 

Example: 

remove "info 

page-name 

The name of an existing page in the current project. 
Example: 

erpage "page3 

pathname 

The name of a file in the current directory or a full 
pathname. A pathname is the name of a path which may 
include the name of the disk (volume name), the name of 
a subdirectory (if subdirectories are being used) and the 
name of a file. 

Example: 
erfile "mydata 


picture-shape-name A valid shape name for a picture box. 


project-name 

Example: 

delshape "myshape 

The name of a Control Lab project in the current directory. 
Example: 

loadtools "test 

[rgb] 

Red, green, and blue components of a color. Three 
numbers between 0 and 65535. Macintosh only. 

Example: 

settc [65000 0 0] 

screen-pos 

Screen coordinates. X-coordinate and Y-coordinate in a 
list. The position [0 0] is in the top, left corner of the 
screen. 

Example: 

setpos [50 50] 

■ sensor-name 

The name of a sensor currently connected on the Setup 
page. 
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true-or-false 

true-or-false- list- 
to-run 


valid-number 


valid-shape-name 


valid-word 


valid-word-or-list 


word 


word-or-list 


An instruction (not necessarily in a list) that reports the 
word true or the word false. 

An instruction list that reports the word true or the word 
false. 

Example: 

if tempi >30 [stop] 

A valid number specific to that primitive. The 
characteristics of a valid number are given in the 
primitive definitions. 

Example: 

setvalue 8 

The name of a shape that is part of the shape list for a 
given type of page element. 

Example: 

setshape "on 

A sequence of characters. The characteristics of a valid 
word are given in the primitives definitions. Macintosh 
only. 

Example: 

setfont "geneva 

A word or a list. The characteristics of the input are given 
in the primitive definitions. Macintosh only. 

Example: 

setstyle "bold 

A sequence of characters. A number is a type of word. 
Example: 

setname "conclusion 

A word or a list. 

Example: 

type "go 


word-or-list-to-run A word or a list that Control Lab can run. 





Sample Project 



Many examples in this chapter relate to the following sample project. 

The project is named Myproj and contains three pages: Pagel, Page2, and 
Page3. 

Pagel contains the following page elements: 

• The graph box has 225 samples in its only curve. 

• The monitor box is monitoring the value of the Speed slider. 

• The button is used to turn on the motor. 



The Setup page has four sensors as well as a motor, a lamp, and a sound 
element connected to the ports. 
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Listing of Primitives 


Following is a description of each LEGO DACTA® Control Lab primitive. 


Infix Math Reporters 

numberl + number2 (Addition) Reporter/2 inputs 


Reports the sum of numberl and number2. See sum. 
Examples: 

show 3+3 

6 

show (tempi *9/5) +32 

20 


numberl - number2 (Subtraction) Reporter/2 inputs 


Reports the result of numberl minus number2. See difference. 
Examples: 

show 3-3 

0 

show (tempi - 32) *5/9 

20 


numberl *number2 (Multiplication) Reporter 12 inputs 


Reports the product of numberl multiplied by number2. See product. 
Examples: 

show 3*3 

9 

show (tempi *9/5) +32 

20 
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numberl / number2 (Division) 

Reporter/2 inputs 


Reports the result of number 1 divided by number2. See quotient and 
remainder. 


Examples: 

show 3/3 

1 

show (tempi *9/5) +32 

20 


word-or-listl = word-or-list2 (Equal to) Reporter/2 inputs 


Reports true if word-or-listl is equal to word-or-list2. An empty word is not 
equal to an empty list. See equal?, <>, and identical? 

Examples: 

show 3=3 

true 

show "a = "A 

true 

talkto "pictl 
show shape = "motor 

true 


number 1 > number2 (Greater than) Reporter/2 inputs 


Reports true if number 1 is greater than number2. See < and greater? 
Examples: 

show 3.1 > 3 

true 

show light5 > 50 

false 
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numberl < number2 (Less than) 

Reporter/2 inputs 


Reports true if numberl is less than number2. See > and less? 
Examples: 

show 2.9 < 3 

true 

show light5 < 80 

true 


numberl >= number2 (Greater than or equal to) 

Reporter/2 inputs 


Reports true if numberl is greater than or equal to number2. See <=, >, <, =, and 
<>. 

Examples: 

show 3 >= 3 

true 

show light5 >= 50 

true 


numberl <= number2 (Less than or equal to) 

Reporter/2 inputs 


Reports true if numberl is less than or equal to number2. See >=, >, <, =, and <>. 
Examples: 

show 3 <= 3 

true 

show light5 <= 50 

false 











word-or-listl o word-or-list2 (Not equal to) 

Reporter/2 inputs 


Reports true if word-or-listl is not equal to word-or-list2. See =, equal?, and 
identical? 

Examples: 

show "a <> [a] 

true 

tto "pictl 

show shape <> "motor 

false 


A 


abs number 


Reporter/1 input 


Stands for absolute. Reports the absolute value of its input. See minus. 
Examples: 

show abs 33 

33 

show minus abs -33 

-33 


activate 


Command/No inputs 


Activates the current monitor box. If a monitor box is monitoring a value that 
does not exist, an error message is displayed and the monitor box is 
deactivated. Set up the environment (e.g., create variables, connect sensors, 
etc.) and then activate the monitor box. See deactivate. 

Example: 

to setup.monitor 

create "monitor "temp [90 90] [50 18] 
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• deactivate 

• setmonfunction [tempi] 

• type [Connect a temperature sensor on port 1 and click on 

• the button.] 

• end 

Clicking the button runs the go procedure which activates the monitor box. 

• to go 

• activate 

• end 


alloff Command/No inputs 

ao 


Turns off all the output ports except the constant output port. This is not 
equivalent to the stop button on the interface box. See on and off. 

Examples: 

talkto [motora lampb] 

on 

talkto "soundc 

on 

alloff 


and true-or-falsel true-or-false2 Reporter/2 inputs 

(and true-or-falsel true-or-false2 true-or-false3...) 

Many inputs when parentheses 

are used. 


Reports true if all its inputs report true; otherwise, it reports false. See or 
and not. 

Examples: 

show and (2=2) (3=3) 

true 

show and (2*4) =8 pos = [0 0] 

false 








show and (tempi 

false 

> 50) ((counter 2) < 15) 

angle input-port-number Reporter/1 input 

Reports the value read at the designated port as an angle, regardless of the 
mode set in the sensor dialog box. An angle sensor can be set in Angle mode or 
in Rotation mode. The input can be any number between 1 and 8, but the 
command only makes sense if the input corresponds to a port number that is 
set as an angle sensor. See angle# and rotation. 

Examples: 


show angle6 

5 

The sensor is set in Rotation mode. 

show angle6 

112.5 

The same value reported as an angle. 

angle# 

Reporter/No inputs 


The actual name of this primitive can be angle5 to angle8. Angle# reports the 
value of the designated angle sensor. The value reported by this primitive 
depends on the setting in the sensor dialog box. The default setting for an angle 
sensor is the Rotation mode. See raw, angle, rotation, and resetrotation. 

Setting in the dialog box: Values reported: 

rotation Rotation, 16 representing one full rotation, 

angle Rotation, in degrees, by increments of 

22.5 degrees. 360 represents a full rotation. 

The dialog box for an angle sensor can be used to reset it to 0 and designate the 
type of reading the sensor should perform (Angle or Rotation). 

Examples: 

show angle6 

2 The sensor is set in Rotation mode. 

show angle6 

4 5 The same value reported as an angle.. 
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arctan number 

Reporter/1 input 


Stands for arc tangent. Reports the arc tangent of its input. See tan, sin, 
and cos. 

Example: 

show tan 45 

1 

show arctan 1 

45 


ascii char Reporter/1 input 


Stands for American Standard Code for Information Interchange. Reports the 
ASCII number which represents the character. The output is a number between 
0 and 255. See char. 

Examples: 

show ascii "a 

97 

show ascii "A 

65 

show ascii readchar Press Return, then type an “a.” 

97 


ask element list-to-run 


Command/2 inputs 


Asks the specified element to run the instruction list without making the 
element current. See talkto. 

Example: 

tto "motora 

ask "lampb [on] Lamp bis on. 

on Motora is turned on. 

off Motora stops. 














average list-of-numbers 

Reporter/1 input 


Reports the average of the numbers in the list. Displays an error message if the 
list is empty or if it contains non-numerical items. See min and max. 

Examples: 

show average [5 10 10 5] 

7.5 

show datalist 1 

[502 502 505 510 ... 990 990] 

show average datalist 1 

722 

B 


bg Reporter/No inputs 


Stands for background. On Macintosh systems, bg reports a list of three 
numbers corresponding to the red, green, and blue components of the 
background color in the current text box, monitor box, or Procedures page. On 
MS-DOS systems, a single number is reported. See setbg and tc. 

Example (Macintosh): 

show bg 

[65000 0 0] 

Example (MS-DOS): 

show bg 

8 


boolean input-port-number 


Reporter/1 input 


Reports the boolean state of the designated sensor, regardless of the reading 
mode set in the sensor dialog box. The input can be any number between 1 
and 8. The boolean state of a touch sensor is related to the state of its switch. 
The boolean state of sensors of other types relates to the way their values have 
changed between the last two samples. 
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Example: 


show touch2 

false 

show boolean 1 

true 


bottom 

Command/No inputs 

Puts the cursor, in the current text box or on the Procedures page, at the end of 
the text. See top. 

Example: 


repeat 5 [print "hello] 
top 

print "say 
bottom 
print "there 


butfirst word-or-list 
bf word-or-list 

Reporter/1 input 

Reports all but the first component of a word or list. See butlast, first, and last. 

Examples: 


show bf [0123] 

[1 2 3] 

show bf [hello there] 

[there] 

show butfirst butfirst "mypict 

pict 


butlast word-or-list 
bl word-or-list 

Reporter/1 input 


Reports all but the last component of a word or list. See butfirst, first, and last. 










Examples: 

show bl [0123] 

[0 1 2 ] 

show bl [hello there] 

[hello] 

show butlast "lampb 

lamp 


C 


carefully list-to-runl list-to-run2 Command or reporter/2 inputs 


Runs the first list of instructions. If the first list contains an error, carefully runs 
the second list of instructions. If there is no error in the first list, the second list 
is ignored. See Appendix 4, Control Lab Messages. 

Example: 

These instructions must be typed as is on the Procedures page or on one line in 
the Command Center. 

carefully [erasefile "menu] 

[pr " | There is no such file I ] 


cc Command/No inputs 


Stands for clear the Command Center. See cleartext, showcc, and hidecc. 
Example: 

cc type [Click on the arrow to start.] 


Celsius input-port-number Reporter/1 input 


Reports the value read at the designated port in Celsius, regardless of the 
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reading mode set in the sensor dialog box. A temperature sensor can be set in 
Celsius mode or in Fahrenheit mode. The input can be any number between 1 
and 8, but the command only makes sense if the input corresponds to a port 
number that is set as a temperature sensor (ports 1 to 4). See fahrenheit. 

Example: 

show tempi 

6 8 The sensor is already set in Fahrenheit mode. 

show Celsius 1 

2 o The same value in Celsius. 


eg 


Command/No inputs 


Stands for clear graphics. Clears the graphics in the current picture box. The 
shape of that picture box first has to be opened for changes. See openshape, 
lineto, and moveto. 

Example: 

talkto "mypict 
openshape "scan 
lineto [10 10] 
eg 

closeshape 


char valid-number 


Reporter/1 input 


Stands for character. Reports the character represented by the ASCII number 
given as input. The input must be between 0 and 255. See ascii. 

Examples: 

show char 97 

a 

show char 65 

A 

show (word "Hel char 32 "lo) 

Hel lo 












chdir pathname 
cd pathname 

Command/1 input 


Stands for change directory. Designates a new directory (folder) for loading and 
saving files. A new directory can also be set by using the Open or Save dialog 
boxes. Levels are separated by a colon (:). When spaces are used, vertical bars 
must be used to surround the input. See currentdir and setprefix. 

Examples (Macintosh): 

chdir "I hard disk:I 
show projectlist 

[] 

chdir "I Ctrl lab I 
show projectlist 

[sunset bar test] 

Examples (MS-DOS): 

chdir c:\mydisk 
show projectlist 

[] 

chdir c:\ctrlab 
show projectlist 

[sunset bar test] 


clearcurve curve-number Command/ 1 input 


Clears the designated curve in the current graph box. The input must be a 
number between 1 and 4 inclusive. Clearcurve displays an error message if the 
current graph box is currently sampling. See clearcurves. 

Example: 

start sample Wait a while. 

stopsample 
clearcurve 1 

start sample Wait a while. 

stopsample 
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clearcurves 

Command/No inputs 

Clears all four curves in the current graph box. The sampling functions remain 
intact. Clearcurves gives an error message if the current graph box is currently 
sampling. See clearcurve. 

Example: 


startsample 

stopsample 

clearcurves 

startsample 

stopsample 

Wait a while. 

Wait a while. 

clearname word 

Command/1 input 


Clears the named variable from memory. Clearname does not report an error if 
the input is not the name of an existing variable. Clearing unneeded variables 
can free up memory. See clearnames, make, name?, printnames, and name. 

Example: 

make *speed 5 
make "direction "right 
clearname "direction 
printnames 

make "speed 5 Printed in the current text box. 


clearnames 


Command/No inputs 


Clears all the variables from memory. Clearing unneeded variables can free up 
memory. See clearname, make, name?, printnames, and name. 

Example: 

make "speed 5 

make "direction "right 

clearnames 











printnames 

Nothing is printed. 


clearpage Command/No inputs 

cp 


Clears the current page. If the Setup page is the page currently displayed, 
clearpage disconnects all the icons. If the Procedures page is currently 
displayed, clearpage clears all the procedures. On any other page, it clears all 
the page elements. See clearproject. 

Example: 

clearpage 


clearproject Command/No inputs 


Closes the whole project (all pages, including Setup and Procedures) without 
saving it. See clearpage and closeproject. 

Example: 

clearproject 


cleartext Command/No inputs 

ct 


On a page, cleartext clears the text in the current text box. If the Procedures 
page is currently displayed, cleartext clears all the procedures. See clearpage 
and clearproject. 

Example: 

print "hello 
cleartext 
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cleartools 

Command/No inputs 


Erases all the tools procedures from the computer’s memory. See loadtools and 
toollist. 


Example: 

loadtools "test 
show toollist 

[arm go pickup drop] 

cleartools 
show toollist 

[] 


closeproject 


Command/No inputs 


Saves the current project and closes it. See clearproject and nameproject. 
Example: 

closeproject 


closeshape Command/No inputs 


Closes the currently opened shape to protect it from changes. Ends the 
creation process of the shape that started with the openshape command. 
See openshape. 

Example: 

openshape "conv.ctrl 
lineto [50 50] 
closeshape 


cos number Reporter/1 input 


Stands for cosine. Reports the cosine of its input. See sin and tan. 















Examples: 

show cos 60 

0.5 

show cos angle6 

0.5 


count word-or-list Reporter/1 input 


Reports the number of components in the word or the list. 
Examples: 

show count "hello 

5 

show datalist 1 

[502 502 505 510 ... 990 990] 

show count datalist 1 

225 


counter input-port-number Reporter/1 input 


Counter is used to get the counter value of a given sensor. The counter of a 
touch sensor is incremented each time its switch is pressed. The counters of 
other sensors are incremented each time their boolean state goes from false to 
true, regardless of the setting in the dialog box. See resetcounter and boolean. 

Examples: 

show counter 2 

6 

resetcounter 2 
show counter 2 

0 


create valid-word word screen-pos size Command/4 inputs 


Creates an element and gives it a name. The first input must be one of the 
following words: button, slider, monitor, text, picture, or graph. Use either 
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Control Lab Logo commands or the dialog box to change the characteristics of 
the element. 

See remove. 

Examples: 

create "button "main [50 50] [50 30] 

create "slider "level [50 80] [50 30] 


currentdir 


Reporter/No inputs 


Stands for current directory. Reports the name of the current directory or 
folder for loading and saving files. Levels are separated by a colon (:). See chdir 
and prefix. 

Example (Macintosh): 

show currentdir 

hard disk:Ctrl lab 

Example (MS-DOS): 

show currentdir 

\ctrlab\ 


D 


datalist curve-number Reporter/1 input 

Reports a list containing all the values for the designated curve in the current 
graph box. See setdata. 

Example: 


show datalist 1 

[502 502 505 510 ... 990 990] 













deactivate 

Command/No inputs 


Deactivates the current monitor box. Set up the environment (e.g., create 
variables, connect sensors, etc.) and then activate the monitor box. 

See activate. 

Example: 

to setup 

create "monitor "temp [90 90] [50 18] 

deactivate 

setmonfunction [tempi] 

type [Connect a temperature sensor on port 1 and click on 

the button.] 

end 

Clicking the button runs the go procedure which activates the monitor box. 

to go 
activate 

end 


delshape picture-shape-name Command/1 input 


Stands for delete shape. Deletes a shape froirKhe list of available shapes for 
picture boxes. The pre-defined shapes and those currently used in the project 
cannot be deleted. Only those created with openshape or loaded with 
loadshapes can be deleted. See loadshapes, renameshape, and openshape. 

Example (the shape myshape is not currently used in any picture box in 
the project): 

delshape "myshape 


difference numberl number2 Reporter/2 inputs 


Reports the result of subtracting number2 from numberl. 
See - and sum. 
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Examples: 

show difference 7 3 

4 

show difference 100 light5 

30 


drawingpos 


Reporter/No inputs 


Stands for drawing position. Reports the drawing position for the line tracer in 
the current picture box. A shape must first be opened for changes by using 
openshape. See lineto and moveto. 

Examples: 

create "picture "myshape [0 100] [100 100] 

openshape "myshape 
show drawingpos 

[0 0 ] 

lineto [20 20] 
moveto [20 30] 
show drawingpos 

[20 30] 

closeshape 


E 


elemendist 


Reporter/No inputs 


Reports a list of all the page elements contained in the current project, and the 
names of the sensors, motors, lamps and sound elements connected to the 
ports on the Setup page. See talkto and ask. 

Example: 

show elementlist 

[textl pictl mypict monitor1 buttonl graphl motora] 












empty? word-or-list 

Reporter/1 input 


Reports true if the input is an empty word or empty list; otherwise, it 
reports false. 

Example: 

clearcurves 

show empty? datalist 1 

true 

show datalist 1 

[] 


end Special word 

Ends a procedure definition on the Procedures page. See to. 
Example: 

to car 

end 


equal? word-or-listl word-or-list2 Reporter/2 inputs 


Reports true if the two inputs are equal. The empty word and the empty list are 
not equal. Equal is not case sensitive. See = and identical? 

Examples: 

show equal? "a "A 

true 

show equal? 4 count "hello 

false 

show equal? touch2 "true 

true 
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erasefile pathname 
erfile pathname 

Command/1 input 


Erases any type of file if it is not locked. The input must be the name of a file in 
the current folder (directory) or a full pathname. Vertical bars must be used to 
enclose a name that contains spaces. See erpage and erproject. 

Example: 

erfile "rnydata 


erpage page-name Command/1 input 

Stands for erase page. Deletes the named page from the current project. A. 
project must always contain at least one page. See clearpage and clearproject. 

Example: 

erpage "page3 


erproject project-name 


Command/1 input 


Stands for erase project. Erases a Control Lab project. The input must be the 
name of a project in the current folder (directory). See clearproject and erpage. 

Example: 

erproject "test 


errormessage 


Reporter/No inputs 


Reports the last error message displayed by Control Lab or trapped by carefully. 
If errormessage reports an empty word, it means that the last operation using 
carefully did not report an error. See Appendix 4, Control Lab Messages for a list 
of error messages. See carefully. 












Example: 

carefully [talkto "text8] [show errormessage] 

talkto doesn't like text8 as input 



fahrenheit input-port-number Reporter/1 input 


Reports the value read at the designated port in Fahrenheit, regardless of the 
mode set in the sensor dialog box. A temperature sensor can be set in Celsius 
mode or in Fahrenheit mode. The input can be any number between 1 and 8, 
but the command only makes sense if the input corresponds to a port number 
that is set as a temperature sensor (ports 1 to 4). See Celsius. 


Example: 


show tempi 

20 

The sensor is set in Celsius mode. 

show fahrenheit 1 

68 

The same value, in Fahrenheit. 


false 


Special word 


False is a special word used by many Control Lab primitives such as if, and, 
ifelse, and not. Many other Control Lab primitives or logical expressions report 
true or false. For example: boolean, =, number? and empty? report true or 
false. See true. 

Example: 

show 4=3 

false 

ifelse 4=3 [show "yes] [show "no] 

no 

if touch2 = "false [tone 90 2] 
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first word-or-list 

Reporter/1 input 


Reports the first component of the word or list. See butfirst, butlast, and last. 
Examples: 


show first "hello 

h 

show first elementlist 

textl 


flash numberl number2 Command/2 inputs 


Turns the current output port(s) on and off. The first input sets the on duration, 
and the second input sets the off duration. The duration is in tenths of a 
second. Use the off command to make the port(s) stop flashing, and on to 
resume. The instruction flash 0 0 disables the flashing for that port and turns it 
off. 

Examples: 

talkto [motors lampb] 
flash 20 10 
off 
on 

flash 0 0 


font 


Reporter/No inputs 


Reports the font used in the current text box or monitor box, or on the 
Procedures page if it is showing. Macintosh only. 

Example: 

show font 

Geneva 












fontlist 

Reporter/No inputs 


Reports a list containing the names of all the fonts available. See setfont. 
Macintosh only. 

Example: 

show fontlist 

[Monaco New York Times Geneva] 


fontsize Reporter/No inputs 


Reports the font size used in the current text box or monitor box, or on the 
Procedures page if it is showing. Macintosh only. See setfontsize. 

Example: 

show fontsize 

9 

setfontsize fontsize * 2 


forever list-to-run 


Command/1 input 


Runs the input repeatedly as a parallel process. The instruction must be a 
command (as opposed to a reporter). The stop command is not sufficient to 
stop a process created by a forever instruction. Use the Stopall menu item or 
the command stopall or stopme. See stopall and stopme. 

Examples: 

forever [rd wait 20] 

forever [on wait 5 off wait 5] 

stopall 


fput word-or-list list 


Reporter/2 inputs 


Stands for first put. Reports the list created by adding the first input at the 
beginning of the second. See lput. 
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Examples: 


show fput "hello [there] 

[hello there] 

show fput [hello] [there] 

[[hello] there] 

G 


getpage page-name 
gp page-name 

Command/1 input 

Displays the specified page. The input must be the name of a page in the 
current project. See getproject. 

Examples: 


to slideshow 
getpage "pagel 
wait 10 

getpage "page2 
wait 10 

getpage "page3 
end 


getproject project-name 

Command/1 input 


Saves the current project, and gets the specified project. If you do not want to 
save the current project, close it using the Close box or the Close menu item, 
and click No when asked to save. See getpage and newproject. 

Example: 


getproj ect "sunset 













gettext 

Reporter/No inputs 


Reports the text contained in the current text box as a character string. All 
spaces and forced carriage returns (where the user has pressed the Return or 
Enter key) are included in the string. Typing the name of the text box has the 
same effect. See parse. 

Examples: 

show gettext 

This is some text 

show textl 

This is some text 

show count gettext 

17 

show parse gettext 

[This is some text] 

show count parse gettext 

4 


greater? numberl number2 Reporter/2 inputs 


Reports true if the first input is greater than the second input. See less? and >. 
Examples: 

show greater? 4 3 

true 

if greater? touch2 10 [print "enough] 

H 


hidecc Command/No inputs 


Stands for hide Command Center. Hides the Command Center without 
clearing it. Once the Command Center is hidden, use the Command Center 
item in the Windows menu to make it reappear. Control Lab opens the 
Command Center when an error occurs. The K-D key (Macintosh) or Alt-D 
(MS-DOS) combination toggles between showing and hiding the Command 
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Center. See showcc and Menus pages 1.6-1.10. 

Example: 

hidecc wait 10 showcc 

hideframe Command/No inputs 


Hides the frame around the current page element. Works with text, graph and 
monitor boxes. See showframe and hidename. 

Example: 

talkto "pictl 

hideframe wait 20 showframe 

hidename Command/No inputs 


Hides the name of the current page element. Works with text, graph and 
monitor boxes. Showname and hidename can be used to make a button visible 
or invisible, providing the button has its default shape. See showname. 

Example: 

talkto "pictl 

hidename wait 20 showname 


hidescales Command/No inputs 


Hides the scales in the current graph box. See showscales. 

Example: 

hidescales 

showscales 
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hidetools 


Command/No inputs 


Hides the Tools Palette. The £§-T (Macintosh) or Alt-T (MS-DOS) key 
combination toggles between showing and hiding the Tools palette. See 
showtools and Menus pages 1.6-1.10. 

Example: 


hidetools 

showtools 

1 


identical? word-or-listl word-or-list2 

Reporter/2 inputs 

Reports true if both inputs are identical. Identical? is case sensitive (a is not 
identical to A). See equal?, =, and <>. 

Example: 


show identical? "a "A 

false 


if true-or-false list-to-run 

Command/2 inputs 


Runs the instruction list only if the condition (first input) reports true. 
See ifelse. 

Examples: 

if member? "textl elementlist [print "Hi] 

Write the following procedure on the Procedures page: 

to raise :number 
if :number > 8 [stop] 
setvalue :number 
wait 10 
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raise :number + 1 
end 

Type this in the Command Center: 

raise 0 

ifelse true-or-false list-to-runl list-to-run2 

Command/3 inputs 

Runs the first instruction list if the condition is true. Runs the second 
instruction list if the condition is false. See if. 

Example: 

These instructions must be typed on the Procedures page or on one line in the 
Command Center. 

ifelse 12000 < timerl [startsample] [show [too soon!]] 

insert word-or-list Command/1 input 


Prints the input at the cursor position, in the current text box or on the 
Procedures page. The text is not followed by a carriage return. See print, type, 
and show. 

Examples: 

insert "hi 
insert char 32 
pr "there 


insertitem valid-number list word-or-list 

Reporter/3 inputs 


Reports the list with the last input inserted at the position specified by the 
valid-number. The resulting list has one more item than the original. 
Insertitem can be used to add new data to an existing graph. The first input 
must be a number between 1 and the number of components in the list, plus 1. 














See removeitem and replaceitem. 

Examples: 

show insertitem 4 [how are you] "today 

[how are you today] 

show insertitem 4 [how are you] [today] 

[how are you [today] 

Example of data insertion into a graph: Datalist reports the list of values 
corresponding to a curve of the current graph box. Insertitem adds the number 
0 at the first position in that list and setdata uses the resulting list to build the 
second curve of the graph. 

setdata 2 insertitem 1 datalist 1 0 

The same operation can be done in three steps: 

make "temp datalist 1 
show :temp 

[502 502 505 510 ... 990 990 ] 

make "temp insertitem 1 :temp 0 
show :temp 

[0 502 502 505 510 ... 990 990 ] 

setdata 2 :temp 


int number Reporter/1 input 

Stands for integer. Reports the integer portion of its input. See round. 
Example: 

show int 3.3333 

3 


item valid-number word-or-list Reporter/2 inputs 


Reports a specified component of a word or list. The first input must be a 
number between 1 and the number of components in the word or list given as 
second input. See insertitem and removeitem. 
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Examples: 


show item 2 "hello 

e 

show item 2 [hello there] 

there 

show item 2 datalist 1 

502 


itempos word-or-list list 


Reporter/2 inputs 


Stands for item position. Reports a number representing the rank of the first 
occurrence of the first input in the second input. Itempos gives an error 
message if the first input is not an item of the second input. See insertitem. 

Examples: 

show itempos "c [abode] 

c not found 

show itempos "c [abode] 

3 

show itempos 22 [18 20 20 21 22 22 25] 

5 

In the following example, carefully will run the first statement if the item is part 
of the list, and display a message otherwise. This method has the advantage of 
not stopping the procedures the way a plain error message would. Type the 
following procedure on the Procedures page: 

to where :item :list 
carefully 

[show itempos :item :list] 

[show se :item [is not included!]] 
end 

Type this in the Command Center: 

where 608 datalist 1 

66 

where 610 datalist 1 

[610 is not included!] 









K 


key? 

Reporter/No inputs 


Reports true if a key is being pressed on the keyboard. Key? can only be used 
when there is no blinking cursor (for example, click on the background of your 
page). See shift?, option? and readchar. 

Examples: 

repeat 10 [show key?] 

false 

false 

false 

true 

true 


waituntil [key?] print "hi Wait a while, then press a key. 

hi 


L 


last word-or-list Reporter/1 input 


Reports the last component of the word or list. See butfirst, butlast and first. 
Examples: 

show last "hello 

o 

show last [hello there] 

there 

show last datalist 1 

990 
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launch list-to-run 

Reporter/1 input 


Runs the input as a parallel process. The cursor reappears in the Command 
Center as soon as the process is launched when the process is launched from 
the Command Center. See stopme and stopall. 


Example: 

These instructions must be typed on the Procedures page or on one line in the 
Command Center. 

launch [repeat 999 [make "x random 2 wait 5]] repeat 25 
[show :x] 

0 

1 

1 

0 

1 


less? numberl number2 Reporter/2 inputs 


Reports true if the first number is less than the second number. See <. 
Examples: 

show less? 22 22.5 

true 

show less? 20 tempi 

true 


light# 


Reporter/No inputs 


The actual name of this primitive can be light5 to light8. Light# reports the 
value of the designated light sensor. The value reported by this primitive 
depends on the setting in the sensor dialog box. The default setting for a light 
sensor is the Percent mode. See raw. 

The value reported by this primitive corresponds to the percentage of light read 
by the sensor (100 being the maximum). 










Setting in the dialog box: Values reported: 

percent A number between 0 and 100, 

representing the percentage of light 
read by the sensor. 

raw A number between 0 and 1023. 

The raw value read by the sensor. 

Example: 


show light5 

77 

show raw 5 

882 

The sensor is already set in Percent mode. 

The same value in Raw mode. 

limits 

Reporter/No inputs 

Reports a list containing the lower and upper limit values of the current slider. 
See setlimits. 

Example: 


talkto "speed 
show limits 

[0 8] 

show speed 

4 


lineto drawing-pos 

Command/1 input 


Traces a line in the shape of the current picture box, from the current position 
to the position indicated. The coordinates start at [0 0] at the top left corner of 
the box. The limits correspond to the size of the picture. The shape must first 
be opened for changes. See openshape and moveto. 


Examples: 

talkto "raypict 
openshape "myshape 
lineto [50 50] 
lineto [0 10] 
closeshape 


[0 0] • [50 0] 
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list word-or-listl word-or-list2 Reporter/2 inputs 

(list word-or-listl word-or-list2 word-or-list3...) 

Many inputs when parentheses 
are used. 


Reports one list made by combining the inputs (words or lists). See sentence, 
list? and word. 

Examples: 

show list 2 3 

[2 3] 

show list "a "b 

[a b] 


list? word-or-list 


Reporter/1 input 


Reports true if the input is a list; otherwise, it reports false. See word? 
Example: 

show list? [] 

true 

show list? datalist 1 

true 


loaddata pathname 


Command/1 input 


Loads the data found in the named file into the current graph box. New data 
overwrites the current curves, if any. A data file is created with the savedata 
command. It can be looked at as a plain text file, using the loadtext command. 

Example: 

savedata "sunset 
clearcurves 
loaddata "sunset 
loadtext "sunset 














loadpict pathname 

Command/1 input 


Loads the picture from the designated picture file into a new shape and then 
creates a picture box with this shape. The pathname must include the 
extension of the picture file. MS-DOS only. 

Example: 

loadpict "flower.pcx 


loadprocs project-name Command/1 input 


Stands for load procedure. Loads the procedures contained on the Procedures 
page of the named project. The procedures are added to the Procedures page 
of the current project. An error message is displayed if two procedures have the 
same name. See loadtools. 

Example: 

1oadprocs "sunset 


loadshapes project-name Command/1 input 


Loads the shapes (those for the picture boxes) contained in the named project. 
If a new shape has the name of an existing one, the new one has priority. 

See renameshape. 

Example: 

loadshapes "sunset 


loadtext pathname Command/1 input 


Loads the text from the designated text file in the current text box or on the 
Procedures page. Text can be loaded from a standard text file from another 
application or from a file created with savetext or savedata. See savetext. 
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Example: 

loadtext "info 


loadtools project-name 

Command/1 input 


Loads, as tools, the procedures contained on the Procedures page of the named 
project. If a tool procedure has the same name as a procedure in the current 
project! the procedure definition will be used as long as it exists. See loadprocs 
and cleartools. 

• Example: 

• loadtools "test 


local word-or-list Command/1 input 


Makes the specified variable local to the procedure where local is used. Local 
can only be used in a procedure. See make and name. 

Example: 

to test rvalue 
go 

show rvalue 
end 

to go 

local "value 
make "value 30 
show rvalue 

Try the test procedure with 10 as input. The variable rvalue will have the value 
30 only while the procedure go is running. Its value is still 10 when the show 
instruction of the test procedure is executed. 

• test 10 

30 

10 
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loop list-to-run 

Command/1 input 

Runs the list of instructions forever. 

Example: 

talkto "motora on 
loop [wait 50 rd] 



lput word-or-list list 


Reporter/2 inputs 


Stands for last put. Reports the list created by adding the first input at the end 
of the second. See fput. 

Examples: 

show lput [there] "hello 

[hello there] 

show lput [there] [hello] 

[[hello] there ] 



make word word-or-list 


Command/2 inputs 


Creates a variable and gives it the value word-or-list. In general, variables 
created with make are “global” and remain in the computer’s memory even 
when the project is changed. 

Variables are not saved in a project unless the make instructions are put inside 
procedure definitions. Once the variable is created, the value can be accessed 
by :word or thing "word. The: (colon) means “the value of.” 

Examples: 

make "class [Peter Anne Dennis Geni] 
show :class 

[Peter Anne Dennis Geni] 
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To save variables, put them in procedures on the Procedures page. 

• to startup 

• make "numbers [012345] 

• make "message [hello there] 

• end 

Note: A shortcut for doing this consists of going to the Procedures page and 
typing the printnames command in the Command Center. All the make 
statements will be printed at the cursor position on the page. Simply add a title 
: line and an end at the end of the procedure. Running this procedure after 
loading the project will recreate the variables. 


max list-of-numbers Reporter/1 input 


: Stands for maximum. Reports the biggest number in the list. Max gives an 

• error if the list is empty, if the list contains items that are non-numerical and if 
the input is not a list. 

Examples: 

• show max [23 56 45 23] 

• 56 

• show datalist 1 

: [502 502 505 990] 

• show max datalist 1 

: 990 


member? word-or-listl word-or-list2 Reporter/2 inputs 


: Reports true if the first input is a component of the second. Member? reports 
an error message if the first input is a list and the second is a word. 

Examples: 

• show member? "a [a b c] 

true 

: show member? "green pagelist 

false 












min list-of-numbers 

Reporter/1 input 


Stands for minimum. Reports the smallest number in the list. Min gives an 
error if the list is empty, if the list contains items that are non-numerical and if 
the input is not a list. 

Examples: 

show min [23 56 45 23] 

23 

show datalist 1 

[502 502 505 510 ... 990 990] 

show min datalist 1 

502 


minus number Reporter/1 input 


Reports the additive inverse of its input. See - and difference. 
Examples: 

show minus 5 

-5 

show minus abs -5 

-5 


mousebutton? 


Reporter/No inputs 


Reports true if the mouse button is pressed. See key? 
Examples: 

repeat 10 [show mousebutton?] 

false 

false 

false 

true 

true 

false 
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Following instructions must be typed on the Procedures page or on one line in 
the Command Center. Use stopall to stop this process. 

• tto "motors 

• forever [ifelse mousebutton? [on] [off]] 


mousepos 


Reporter/No inputs 


Stands for mouse position. Reports the screen coordinates representing the 
current mouse position. The coordinates start at [0 0] at the top left corner of 
the page. 

Examples: 

show mousepos 

[50 63] 

show first mousepos 

50 

talkto "speed 
setpos mousepos 

Place the mouse pointer somewhere on the page and press Return or Enter. 
The slider named speed is moved to that position. 


moveto drawing-pos 


Command/1 input 


Moves the current position, without tracing a line, to the absolute position 
indicated. The coordinates start at [0 0] at the top left corner of the picture box. 
The shape must first be opened for changes. See openshape and lineto. 

Example: 

openshape "myshape 
lineto [50 50] 

• moveto [10 10] 

• lineto [10 20] 

• closeshape 











N 


name word-or-list word 

Command/2 inputs 


Creates a variable and gives it the value word-or-list. In general, variables 
created with name are global and remain in the computer’s memory even 
when projects are changed. 


The function of name is identical to make, but the inputs are in the reverse 
order. See make, clearname, clearnames, and printnames. 

Example: 

name 5 "speed 
setpower :speed 


name? word Reporter/1 input 


Reports true if the input is the name of a variable. See make and name. 

Example: 

make "age 10 
show name? "age 

true 


namepage word Command/1 input 

np word 


Gives a name to the current page. A page has a default name when it is opened 
(e.g., Pagel). See nameproject and clearpage. 

Example: 

namepage "intro 
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nameproject valid-word 

Command/1 input 

Gives a name to the current project and saves it as is. See namepage. 

Example: 


nameproject "myproj 


newpage 

Command/No inputs 

Opens a new page. See clearpage, namepage, and newproject. 

Example: 


newpage 
namepage "lab 


newproject 

Command/No inputs 


Saves the current project and displays the Setup page of an empty and 
unnamed project. See clearproject and newpage. 

Example: 

newproject 


not true-or-false 


Reporter/1 input 


Reports the logical inverse of its input. See and and or. 
Examples: 

show empty? [] 

true 

show not empty? [] 

false 

show not empty? datalist 1 

true 

















number? word-or-list 

Reporter/1 input 


Reports true if the input is a number; otherwise, it reports false. 
Example: 

show number? first datalist 1 

true 

0 

off Command/No inputs 


Turns off the output ports. See talkto, alloff, and on. 
Example: 

talkto [motora lampb] 

on 

off 


on 


Command/No inputs 


Turns on the output ports. See talkto, alloff, and off. 
Example: 

talkto [motora lampb] 

on 

off 




\ 
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onfor number 

Command/1 input 


Turns on the output ports for a specified duration. The duration is indicated in 
tenths of a second or in angle sensor steps. An angle sensor can be linked to a 
motor in the motor dialog box. See talkto, on, off, alloff, and the description of 
the motor dialog box on page 1.13. 

Example: 

talkto [motora lampb] 

on 

off 

onfor 20 


openshape valid-word 


Command/1 input 


Creates a new shape by opening the shape in the current picture box. The input 
must be a shape name that is not reserved. See closeshape. 

Example: 

openshape "try 
lineto [50 50] 
closeshape 


option? Reporter/No inputs 


Reports true if the Option key is currently pressed. See key? and shift? 
Macintosh only. 

Examples: 

repeat 10 [show option?] 

false 

false 

true 

true 

false 
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This instruction must be typed on the Procedures page or on one line in the 
Command Center. Use stopall to stop this process. 

forever [ifelse option? [showframe] [hideframe]] 


or true-or-falsel true-or-false2 Reporter/2 inputs 

(or true-or-falsel true-or-false2 true-or-false3...) 

Many inputs when parentheses are used. 


Reports true if any of its inputs report true; otherwise, it reports false. The 
input to or must report true or false. See and and not. 

Examples: 

show or (2 = 2) (3=5) 

true 

show or (2 * 4) = 8 pos = [00] 

true 


output word-or-list Reporter/1 input 

op word-or-list 


Stops the procedure and reports a word or list. Output can only be used within 
a procedure. Output is the primitive that makes a procedure act like a reporter. 
See stop. 

Examples: 

to firstnum :list 
if empty? :list [op "none] 
if number? first :list 
[op first :list] 
op firstnum bf : list 
end 

In the Command Center, try: 

show firstnum [abcde6fghij] 

6 

show firstnum [abcdefghij] 

none 
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pagelist 


Reporter/No inputs 


Reports a list containing the names of all the pages in the current project. 
See projectlist. 

Examples: 

show pagelist 

[pagel page2 page3] 

getpage "pagel 

namepage "intro 

show member? "intro pagelist 

true 


parse word-or-list 


Reporter/1 input 


Turns character strings into plain lists. Spaces and carriage returns contained in 
the character string become separators in the list. 

Examples: 

show textl 

This is some text 

show count textl 

17 There are 14 characters and 3 spaces, 

show parse textl 
[This is some text] 

show count parse textl 

4 There are four words in the list. 


percent input-port-number Reporter/1 input 


Reports the value read by the designated sensor as a percentage, regardless of 
the mode set in the sensor dialog box. A light sensor can be set in Percent mode 
or in Raw mode. The input can be any number between 1 and 8, but the 
command only makes sense if the input corresponds to a port number that is 
set as a light sensor (ports 5 to 8). 














Example: 

show light5 

664 The sensor is in Raw mode. 

show percent 5 

57 The same value, as a percent. 


pos Reporter/No inputs 


Stands for position. Reports the position of the current page element (text, 
button, monitor, picture, graph, or slider). The result is a list of two numbers. 
[0 0] is the position at the top left corner of the page. See setpos. 



Examples: 

The second example moves the current page element 10 pixels to the right. 

show pos 

[50 50] 

setpos list (10 + first pos) 50 


power Reporter/No inputs 


Reports the power level of the current motor or lamp. See setpower. 

Examples: 

talkto "lampb 
setpower 2 
show power 

2 

repeat 5 [setpower power + 1] 
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prefix Reporter/No inputs 

Reports the name of the current directory or folder. Same as currentdir. 
See chdir and setprefix. 

Example (Macintosh): 

show prefix 

hard disk:Ctrl lab: 

Example (MS-DOS): 

show prefix 

\ctrlab\ 

print word-or-list Command/1 input 

pr word-or-list 

Prints a word or list in the current text box or on the Procedures page. 
Word-or- list is followed by a carriage return. See show, insert, and type. 

Example: 

repeat 5 [print "hello] 


printnames 


Command/No inputs 


Prints out all variables in memory in the current text box or on the Procedures 
page. See make, name, and printnames. 

Example: 

make "age 10 

make "days [mon tues wed] 
printnames 

make "age 10 

make "days [mon tues wed] 













printpage 

Command/No inputs 


Prints out the current page on the printer. Text boxes are printed the way 
they look on the screen: i.e. text that has scrolled away is not printed. See 
printproject and printtext. 

Example: 

printpage 


printproject Command/No inputs 


Prints out, on the printer, all the pages, including the Procedures page and the 
Setup page of the current project. Text on the Procedures page is printed 
entirely. See printpage and printtext. 

Example: 

printproject 


printtext Command/No inputs 


Prints out, on the printer, the contents of the current text box or the Procedures 
page, depending on which page is currently showing. Text that has scrolled 
away is printed. See printpage and printproject. 

Example: 

printtext 


product numberl number2 Reporter/2 inputs 

(product numberl number2 number3...) 

Many inputs when parentheses are used. 


Reports the result of multiplying its inputs. 
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Examples: 


show product 3 3 

9 

show (product 333) 

27 

show product 10 light5 

750 


projectlist 

Reporter/No inputs 

Reports a list containing the names 

of all the projects in the current directory 

or folder. See pagelist. 

Example: 

show projectlist 

[bar sunset test] 

Q 

quotient numberl number2 

Reporter/2 inputs 


Reports the result of dividing number 1 by number2. If number2 is 0, Control 
Lab displays an error message. See / and remainder. 

Examples: 

show quotient 3 3 

1 

show quotient angle6 360 

0 











random valid-number 

Reporter/1 input 


Reports a random non-negative integer less than valid-number. The input 
must be a number between 0 and 9999. 

Example: 

show random 100 

2 2 Your result may be different, 

raw input-port-number Reporter/1 input 


Reports the raw value read at the designated port, regardless of the type of 
data setting in that sensor dialog box. The input can be any number between 
1 and 8. See boolean and counter. 

Example: 

show tempi 

24 

show raw 1 

688 


rd 


Command/No inputs 


Stands for reverse direction. Reverses the direction of the output ports. See 
setright, setleft and on. 

Examples: 

talkto "motora 
on 

repeat 5 [rd wait 5] 
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readchar 

Reporter/No inputs 


Stands for read character. Pauses the execution and waits for a character to be 
typed on the keyboard. The character will be “lost” if it is not displayed or put in 
a variable. See key? 


; Example: 

! to getinfo 

! show [Enter a number please] 

! make "answer readchar 

! if number? :answer [print [Thank You]] 
! end 

: Type this in the Command Center: 

! getinfo Type a number. 

! Thank You 


recycle 

Command/No inputs 

Frees up unused computer memory space. See space. 

Example: 


show space recycle show space 

[11145 44127] 

[12345 76127] 

Your result will be different. 

remainder numberl number2 

Reporter/2 inputs 


Reports the remainder after the integer part of number 1 is divided by the 
integer part of number2. If there is no remainder, remainder reports 0. 
See quotient and /. 

Example: 


show remainder 3 3 

0 















remove page-element 

Command/1 input 


Deletes the designated page element. See create. 
Example: 

create "text "info [50 50] [100 100] 
remove "info 


removeitem word-or-list list Reporter/2 inputs 


Reports the list with the specified item removed. The resulting list has one less 
item than the original. The first input must be a component of the list given as 
second input. See insertitem. 

Example: 

The data from the graph box is put in a variable. The biggest number from the 
list is removed, the graph box is cleared, and the new list is put back in the 
graph box. 

make "temp datalist 1 

make "bad max :temp 

make "temp removeitem :bad :temp 

clearcurve 1 

setdata 1 :temp 


renameshape picture-shape-name valid-word 

Command/2 inputs 


Renames an existing shape. After pasting a shape from the Clipboard, a name 
is automatically assigned to the picture and the shape by Control Lab. The 
renameshape command can be used to assign a more significant name to the 
shape. The pre-defined shapes cannot be renamed. The second input must be 
a name that does not exist in the current project. 

Example: 

renameshape "shapel2 "boat 
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repeat number list-to-run 

Command/2 inputs 


Runs the list of instructions the specified number of times. 

Example: 

tto "motora 

repeat 10 [rd wait 60] 


replaceitem valid-number list word-or-list 

Reporter/3 inputs 


Sets the specified item (first input) in the list given as second input, to be the 
word or list given as third input, and reports the resulting list. The original item 
is replaced, and the resulting list has the same number of components as the 
original one. The first input must be a number between 1 and the number of 
components in the list given as second input. See insertitem and removeitem. 

Examples: 

show replaceitem 3 [10 10 10 10 10 10] 22 

[10 10 22 10 10 10 ] 

make "temp replaceitem 3 datalist 1 22 
setdata 1 :temp 


rerandom 


Command/No inputs 


Stands for restart random. Reproduces the same sequence of numbers 
generated by random. After running rerandom, random with the same input 
generates the same sequence of numbers the next time. See random. 

Examples: 

rerandom 

repeat 5 [type random 10] 

85610 Your results will differ. 

rerandom 

repeat 5 [type random 10] 

85610 Same result as above. 












resetcounter input-port-number 

Command /1 input 

Resets the counter of the sensor connected to the designated input port. 

See counter. 

Example: 


show touch2 

22 

resetcounter 2 
show touch2 

0 


resetpicture 

Command/No inputs 

Resets the current picture box to its original size. Macintosh only. 

Example: 


talkto "pictl 
setshape "motor 
setsize [100 100] 
resetpicture 


resetrotation input-port-number 

Command/1 input 


Resets the angle sensor to 0. The angle sensor must be set to measure rotations. 
See angle#, angle, and rotation. 


Example: 

show angle6 

12 

resetrotation 6 
show angle6 

0 
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resettl Command/No inputs 

resett2 

resett3 

resett4 


Stands for reset timer. Resets the designated timer to 0. See timer 1, timer2, 
timer3, and timer4. 

Example: 

show timer2 

34243 

resett2 show timer2 

0 


restoreproject 


Command/No inputs 


Restores the current project to the version that was last saved. See nameproject 
and saveproject. 

Example: 

saveproject 
clearpage 
restoreproject 

Select the page you just cleared. It came back because it was stored as part of 
the project file the last time you saved the project. 


rotation input-port-number Reporter/1 input 


Reports the value read at the designated port as a rotation, regardless of the 
mode set in the sensor dialog box. An angle sensor can be set in Angle mode or 
in Rotation mode. The input can be any number between 1 and 8, but the 
command only makes sense if the input corresponds to a port number that is 
set as an angle sensor. 











Example: 

show angle6 

4 5 The sensor is set in Angle mode. 

show rotation 6 

2 The same result as a rotation. 


round number Reporter/1 input 


Reports the number given as input rounded to the nearest integer. See int. 
Examples: 

show round 55.2 

55 

show round 55.5 

56 


run word-or-list-to-run Command or reporter/1 input 


Runs a word or an instruction list. 

Example: 

The following procedure takes a list of procedure names as input. It displays 
information about the current test and then runs the corresponding procedure. 

to test :list 
if empty? :list 

[print [Tests completed.] stop] 
print se [Currently testing:] first :list 
run first :list 
test bf :list 
end 

to velocity 
end 

to lamps 
end 
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to brakes 
end 


to direction 
end 

Type this in the Command Center: 


test [velocity lamps brakes direction] 

Currently testing: velocity 


Currently testing: 
Currently testing: 
Currently testing: 
Tests completed. 


lamps 

brakes 

direction 


S 


sampling? 


Reporter/No inputs 


Reports true if the current graph box is currently sampling. See startsample and 
stopsample. 

Example: 

if not sampling? [startsample] 


savedata pathname 


Command/1 input 


Saves the data contained in the current graph box as a text file. Data saved 
with savedata can be loaded back with loaddata or as plain text with loadtext. 
See loaddata. 

The format of the text file is the following: 

<0:> <tab> <data in curve 1> <tab> <data in curve 2> <tab> <data in curve 3> 
<tab> <data in curve 4> ccarriage return> <1:> <tab>... 










This is an example of a text file created from a graph box containing two curves: 


0: 22 

556 

1: 22 

560 

2: 23 

542 

3: 25 

511 

4: 


Example: 



savedata "mydata 


saveproject 


Command/No inputs 


Saves the current project without closing it. See nameproject. 

Example: 

saveproject 

savetext pathname Command/1 input 

Saves the text found in the current text box or on the Procedures page as a text 
file. The text can be loaded with loadtext. See loadtext. 

Example: 

savetext "mytext 

sentence word-or-listl word-or-list2 Reporter/2 inputs 

se word-or-listl word-or-list2 

(se word-or-listl word-or-list2 word-or-list3...) 

Many inputs when parentheses are used. 

Reports a list which is made up of its inputs (words or lists). See word and list. 
Examples: 

show sentence "a "b 
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[a b] 

show sentence "a [b] 

[a b] 


setbg [rgb] 


Command/1 input 


Stands for set background. Sets the color for the background in the current text 
box, monitor box, or Procedures page. The effect of setbg depends on your 
hardware setup. On a Macintosh system, the inputs are three numbers 
representing the red, green, and blue components of a color. Each number 
must be between 0 and 65535. On an MS-DOS system, the input is a single 
number between 0 and 15. See bg and settc. 


Examples (Macintosh): 

setbg [65000 0 0] 
setbg [0 65000 0] 
setbg [0 0 65000] 

Examples (MS-DOS): 

setbg 12 
setbg 13 
setbg 0 


Shows the red color. 
Shows the green color. 
Shows the blue color. 


Shows the red color. 
Shows the green color. 
Shows the blue color. 


setbuttonmode valid-word Command/1 input 


Sets the mode for the current button. The input word can be on or on/off. 
See Buttons on page 1.36. 

Example: 

setbuttonmode "on/off 

setcolor number Reporter/1 input 


Sets the color for the line tracer in an opened shape. The number of colors 
depends on your hardware setup. See openshape and lineto. 












Example: 


openshape "myshape 
setcolor 12 
lineto [20 20] 
closeshape 


Examples (Macintosh): 


setcolor 6 
setcolor 11 
setcolor 9 

Shows the red color. 

Shows the green color. 

Shows the blue color. 

Examples (MS-DOS): 


setcolor 12 

setcolor 13 
setcolor 0 

Shows the red color. 

Shows the green color. 

Shows the blue color. 

setcomma 

Command/No inputs 

Makes Control Lab display decimal numbers using the comma to separate the 
integer part from the fractional part. After using setcomma, Control Lab will 
not interpret 3.5 as a number. See setpoint. 

Example: 


setcomma 
show 1/2 

0,5 


setcurvefunction curve-number sensor name 

Command/2 inputs 


Sets the function to be plotted and become the designated curve. The valid 
sensor name can be a sensor not reporting in boolean. 

Examples: 

setcurvefunction 1 "light5 
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setdata curve-number list 

Command/2 inputs 


Sets the data for a given curve in the current graph box. After a setdata 
command, the graph box is redisplayed to reflect the changes. This command 
can be used in conjunction with datalist and another list modifying 
commands. See datalist. 

Examples: 

setdata 1 [100 150 200 250 ...] 

These instructions get the data from curve 1 of the current graph box, set the 
first item of the list to 0, and place the list back into the graph box. 

make "temp datalist 1 
show :temp 

[502 502 505 510 ... 990 990] 

make "temp fput 0 :temp 
show :temp 

[0 502 502 505 510 ... 990 990] 

setdata 1 :temp 


setdd valid-numberl valid-number2 Command/2 inputs 


Stands for set dynamic digital. The first input designates the input number 
(1-8), and the second input sets the dynamic digital value (1-15). 

Sensors can change their boolean state in different ways depending on how 
they are set up. In raw mode (second input = 0) a sensor will report true if its 
raw value is less than 512 and false otherwise. In dynamic digital mode the 
value of the sensor input determines the rate of changes necessary to change 
the boolean state of the sensor. See Boolean. 

Example: 

setdd 5 2 


setfont valid-word 


Command /1 input 


Sets the font for the current text box, monitor box, or for the Procedures page. 












The input must be the name of a system font currently available. See fontlist. 
Macintosh only. 

Example: 

setfont "geneva 

setfontsize valid- number Command /1 input 

Sets the font size for the current text box, monitor box, or for the Procedures 
page. The limitations, for the input, are those of the operating system. 

See setfont. Macintosh only. 

Example: 

setfontsize 12 


setinterval valid-number Command/1 input 


Sets the interval between samplings for the current graph box. The interval is in 
tenths of a second. The input must be at least 0.2. 


See startsample. 

Number of samplings 
per second 
50 
10 
2 
1 

1 sampling per 2 sec. 

1 sampling per 10 sec. 

Example: 

setinterval 2 

startsample 

stopsample 


Input 

Time between samplings 
(in seconds) 

0.2 

0.02 

1 

0.1 

5 

0.5 

10 

1 

20 

2 

100 

10 
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setleft 

Command/No inputs 


Sets the direction of output ports. Setleft only affects current output ports. 
See setright and rd. 

Example: 

talkto "motora 

repeat 10 [setright onfor 20 setleft onfor 20] 


setlimits [number number] Command/1 input 


Sets the upper and lower limits for the current slider. After a setlimits 
instruction, the slider affected by the command reports a value included in the 
specified range. See limits. 

Examples: 

setlimits [-10 10] 
show speed 

0 

setlimits [0 10] 
show speed 

5 


setmonfunction list-to-run Command/1 input 


Stands for set monitor function. Sets a function for the current monitor box. 
The function of a monitor box must be a reporter. See activate and deactivate. 

Example: 

setmonfunction [tempi * 10] 
activate 


setname word 


Command/1 input 


Renames the current page element. Renaming can also be done through the 
















element dialog box. Renaming Setup page elements can only be done through 
a dialog box. 

Example: 

talkto "textl 
setname "conclusion 


setofffunction list-to-run 

Command/1 input 

Sets the off action for the current button. This list of instructions will be run 
whenever the button is turned off. See setonfunction. 

Example: 


setofffunction [stop.car] 

Stop.car is the name of a procedure. 

setonfunction list-to-run 

Command/1 input 


Sets the on function for the current button. This list of instructions will be run 
whenever the button is turned on. See setofffunction. 

Example: 

setonfunction [resetcounter 2] 


setpenpat valid-number Command/1 input 


Stands for set pen pattern. Sets the pen pattern for tracing lines in the shape 
that is currently open. The maximum value is 31. See openshape, moveto, 
and lineto. 

Example: 

openshape "rayshape 
setpenwidth [4 4] 
setpenpat 12 
lineto [50 50] 
closeshape 
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setpenwidth [valid-number valid-number] 

Command/1 input 


Sets the pen width for tracing lines in an opened shape. The first number is the 
width of the line tracer and the second number is its height. The maximum for 
both numbers is 67. See openshape and lineto. 

Example: 

openshape "myshape 
setpenwidth [12 12] 
lineto [50 50] 
closeshape 


setpoint 


Command/No inputs 


Makes Control Lab display decimal numbers using the period to separate the 
integer part from the fractional part. After using setpoint, Control Lab will not 
interpret 3,5 as a number. See setcomma. 

Example: 

setpoint 
show 1/2 
0.5 


setpos screen-pos 


Command/1 input 


Moves the current page element to the designated position. The top, left corner 
of the page is the [0 0] position. See pos. 



\ 


[0 0 ] 














Examples: 

talkto "textl setpos [50 50] 
setpos se (first pos) (20 + last pos) 


setpower valid-number Command/1 input 


Sets the power level of the current output port. The input must be a number 
between 0 and 8 inclusive. See power. 

Examples: 

talkto [motora lampb] 
on 

setpower 0 

repeat 7 [setpower power + 1 wait 10] 


setpreferences valid-numberl valid-number2 

Command/2 inputs 


Sets global parameters for Control Lab. The parameters are saved on disk. 
The first number designates the parameter and the second input designates 
its value: 

Input 1 Input 2 

0 (communication port) 0 (modem port) / (com 1) 

1 (printer port) / (com2) 


Input 1 Input 2 

1 (decimal delimiter) 0 (point) 

1 (comma) 


Example: 

In the following example, the modem or coml port is chosen to communicate 
with the interface box: 

setpreferences 0 0 
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setprefix pathname 

Command/1 input 


Change the name of the current folder or directory. Vertical bars must be used 
to enclose a name that contains spaces. Same as chdir. See chdir, prefix, and 
currentdir. 

Examples (Macintosh): 

setprefix "I hard disk:I 
show projectlist 

[] 

setprefix " I Ctrl lab I 
show projectlist 

[sunset bar test] 

Examples (MS-DOS): 

setprefix c:\mydisk\ 
show projectlist 

[] 

setprefix \ctrlab\ 
show projectlist 

[sunset bar test] 


setright 


Command/No inputs 


Sets the direction of output ports. Setright only affects the motors or sound 
elements connected to the current output ports. See setleft and rd. 

Example: 

talkto "motora 

repeat 10 [setright onfor 20 setleft onfor 20] 


setshape valid-shape-name Command/1 input 


Sets the shape of the current element. The input must match the type of the 
current element. See shape and Appendix 2, Shapes, for a complete table of 
types and shape names. 












Example: 

talkto "buttonl 
setshape "on 

setsize [valid-number valid-number] Command/1 input 


Sets the size of the current page element. The elements that are resizable 
include graph, text, picture, monitor boxes, and sliders and buttons in their 
default shapes. Different page elements have different minimum and 
maximum sizes. Macintosh only. 

Example: 

talkto "textl 
setsize [100 100] 


setsliderfunction list-to-run Command/1 input 


Sets the instruction that the current slider will run when its value is changed. 
Example: 

talkto "speed 

setsliderfunction [talkto "motora setpower speed] 


setstyle valid-word-or-list 


Command/1 input 


Sets the font style in the current text box, monitor box, or on the Procedures 
page. The input can be the name of a style or a list of styles. The valid inputs 
are: plain, bold, italic, outline, underline, and shadow. The style is applied to 
the entire box or the entire Procedures page. See style. Macintosh only. 


Examples: 

setstyle "bold 
setstyle [bold italic] 
show style 

[Bold Italic] 
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settc [rgb] 

Command/1 input 

Stands for set text color. Sets the color for the text in the current text box, 
monitor box, or on the Procedures page. The effect of setcolor depends on your 
hardware setup. The inputs are three numbers representing the red, green, and 
blue components of a color. Each number must be between 0 and 65535. See tc 
and setbg. 

Examples (Macintosh): 


settc [65000 0 0] 
settc [0 65000 0] 
settc [0 0 65000] 

Shows the red color. 

Shows the green color. 

Shows the blue color. 

Example (MS-DOS): 


settc 12 
settc 13 

settc 0 

Shows the red color. 

Shows the green color. 

Shows the blue color. 

setvalue valid-number 

Command/1 input 


Sets the current slider to the designated value and runs the Release function if 
the slider value is changed. The input must be within the current minimum 
and maximum limits. Setting the value of a slider by command has the same 
effect as moving its cursor: the function, if any, is executed. See 
setsliderfunction and value. 

Example: 

tto "speed 
setlimits [-10 10] 
setvalue 8 


setwallpaper picture-shape-name Command/1 input 


Stamps a copy of the shape on the background of the page. The input must be 
the name of a shape related to picture boxes. The top left corner of the shape is 
placed in the top left corner of the page. 











Examples: 


setwallpaper "motor 

setwallpaper " Clears the wallpaper. 

setxorg number 

Command/1 input 

Stands for set x origin. Sets the x origin for the current graph box. This updates 
the graph box if it contains any curves. Setxorg is useful for plotting 
mathematical functions. 

Example: 


setxorg -50 


setyaxis [valid-number valid-number] 

Command/1 input 

Sets the lowest and highest y coordinates for the current graph box. This 
updates the graph box if it contains any curves. The input must be a list of two 
numbers between -99,999 and 999,999. See setxorg. 

Examples: 


setyaxis [0 1000] 
setyaxis [100 800] 


shape 

Reporter/No inputs 


Reports the shape name of the current button, slider, or picture box. See 
setshape and shapelist. 

Example: 

talkto "slider 1 
show shape 

Standard Slider 
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shapelist 

Reporter/No inputs 

Reports a list containing the names of all the valid shape names for the type of 
the current element. See setshape, shape, and Appendix 2, Shapes. 

Example: 


talkto "pictl 
show shapelist 

[motor touch light sound 

lamp ...] 

shift? 

Reporter/No inputs 

Reports true if the Shift key is currently pressed. See key? and option? 

Example: 


repeat 10 [show shift?] 

false 

false 

true 

true 

false 

• • • 


show word-or-list 

Command/1 input 

Prints a word or list in the Command Center. A list is printed with its outer 
brackets showing. See type, print, and insert. 

Examples: 


show "hello 

hello 

show "[hello there] 

[hello there] 

show se "IThe speed is:1 

The speed is: 4 

speed 


Vertical bars are used so the sentence does not have brackets. 













showcc 

Command/No inputs 


Stands for show Command Center. Makes the Command Center visible. The 
£§-D (Macintosh) or Alt-D (MS-DOS) key combination and Command Center 
in the Windows menu alternate between displaying and hiding the Command 
Center. See hidecc. 

Example: 

hidecc wait 10 showcc 


showframe 


Command/No inputs 


Makes the frame of the current page element visible. See hideffame. 
Example: 

talkto "textl 

hideframe wait 10 showframe 


showname 


Command/No inputs 


Makes the name of the current page element visible. Showname and 
hidename can be used to make a button visible or invisible, providing the 
button has its default shape. See hidename. 

Example: 

talkto "textl 

hidename wait 10 showname 


showscales 


Command/No inputs 


Makes the scales visible in the current graph box. See hidescales. 
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Example: 

talkto "graphl 

hidescales 

showscales 


showtools 


Command/No inputs 


Makes the Tools Palette visible. The 3€-T (Macintosh) or Alt-T (MS-DOS) key 
combination and Tools Palette in the Windows menu alternate between 
displaying and hiding the Tools Palette. See hidetools. 

Example: 

hidetools 

showtools 


sin number 


Reporter/1 input 


Stands for sine. Reports the sine of number degrees. See cos, tan, and arctan. 
Example: 

show sin 90 

1 


size 


Reporter/No inputs 


Reports the size of the current page element. See setsize. 

Example: 

talkto "textl 
show size 

[150 120] 
















space 

Reporter/No inputs 

Reports the amount of free space. On Macintosh systems the first number of 
the list is the node space in nodes, and the second is the Macintosh memory 
space in bytes. On MS-DOS systems, only the amount of memory space is 
reported. See recycle. 

Example (Macintosh): 


show space 

[589661 602881] 

Your result will be different. 

Example (MS-DOS): 


show space 

[174528] 


sqrt valid-number 

Reporter/1 input 

Stands for square root. Reports the square root of its input. The input must be a 
non-negative number. 

Examples: 


show sqrt 9 

3 

show sqrt raw 5 

31.96873 


startsample 

Command/No inputs 


Starts plotting in the current graph box. This command has the same effect as 
clicking in the Startsample icon in a graph box. See stopsample. 

Example: 

talkto "graphl 

startsample wait 500 stopsample 


startup 


Special word 


Special name for a procedure that runs automatically when the project is 
loaded. 
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Example (on the Procedures page): 


to startup 
getpage "pagel 
hidecc hidetools 
end 


Leave this project and load it again. The startup procedure will start 
automatically making Pagel of the project appear without a Command Center 
and Tools Palette. 

stop 

Command/No inputs 

Stops the procedure that is running. Stop can only be used in a procedure. 

See stopall and stopme. 

Example: 


to countup :num 
if :num > 100 [stop] 
pr :num 

countup :num + 5 
end 


In the Command Center, type: 


countup 10 


stopall 

Command/No inputs 


Stops all running procedures and processes, including button-generated 
activities, sampling graph boxes, and output ports. The monitor and the graph 
boxes remain active. The ^-period (Macintosh) or Alt-K (MS-DOS) key 
combination is equivalent to this command. See stop and stopme. 

Example: 

Type stopall as the instruction of a button. This button can then be used as a 
screen alternative to the Stop button on the LEGO DACTA Serial Interface. 











stopme 

Command/No inputs 


Stops the process in which this instruction was run. 

Examples: 

This procedure is the on action of a button. It will not start the motor if the 
angle sensor is already above 4. 

to go 

if angle6 > 4 [stopme] 
tto "motora setleft 
on 

waituntil [angle6 > 4] 
off 

stopme 

end 


stopsample 


Command/No inputs 


Stops sampling in the current graph box. This command is equivalent to 
clicking in the Stopsample icon in a graph box that is currently sampling. 
See startsample. 

Example: 

t a1kto "graphl 

startsample wait 500 stopsample 


style 


Reporter/No inputs 


Reports a list that has the name(s) of the style (s) used in the current text box, 
monitor box, or on the Procedures page. Macintosh only. See setstyle. 

Examples: 

show style 

[Bold] 

setstyle [Bold Italic] 
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show style 

[Bold Italic] 

sum numberl number2 

(sum numberl number2 number3...) 

Reporter/2 inputs 

Many inputs when parentheses 
are used. 

Reports the sum of its inputs. See +. 


Examples: 


show sum 3 3 

6 

show (sum 333) 

9 


T 


talkto valid-word-or-list 
tto valid-word-or-list 

Command/1 input 


Designates the current element of its type in the project or the current output 
port on the Setup page. For example, after a talkto "textl instruction, the 
following setpos will address the box named textl. However, the next cleardata 
command will address the current graph box. 

If you have many page elements in your project, you should specify the element 
name before giving an instruction. 

Examples: 

Talkto can be used to designate motors, lamps, and sound elements. The input 
can then be a word or a list: 

talkto "motora 

talkto [motora lampb soundc] 

Talkto can be used to designate a page element. In this case, the input must be 
a single word. A comma placed after the name of the page element also has the 
same meaning as talkto: 










talkto "mypict 

setsize [100 100] 

monitorl, 

setpos [50 50] 

buttonl, setpos [100 100] 

textl, pr "hello 


tan number 


Reporter/1 input 


Stands for tangent. Reports the tangent of its input. See arctan, sin, and cos. 
Example: 

show tan 45 

1 


tc 


Reporter/No inputs 


Stands for text color. On Macintosh systems, it reports a list of three numbers 
corresponding to the red, green,and blue components of the text color in the 
current text box, monitor box, or Procedures page. On MS-DOS systems, it 
reports a number between 0 and 15.See settc and bg. 

Example (Macintosh): 

show tc 

[65000 0 0] 

Example (MS-DOS): 

show tc 

12 


temp# 


Reporter/No inputs 


Stands for temperature. The actual name of this primitive can be tempi to 
temp4. Reports the temperature registered by the specified temperature 
sensor. 
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The value reported by this primitive depends on the mode that is set in its 
dialog box. The default mode for a temperature sensor is Celsius. 

Setting in the dialog box: Values reported: 

Celsius The temperature, in degrees Celsius. 

Fahrenheit The temperature, in degrees Fahrenheit. 

The dialog box for a temperature sensor can be used to adjust the reading 
and to designate the type of reading the sensor should perform (Celsius or 
Fahrenheit). 

Examples: 

show tempi 

20 

show raw 1 

322 

show fahrenheit 1 

68 


textlist 


Reporter/No inputs 


Reports a list containing the names of the text files in the current directory or 
folder. Text files are created by savetext, savedata, or other applications. See 
savetext, savedata, loadtext, and loaddata. 

Example: 

show textlist 

[textl] 


thing valid-name 


Reporter/1 input 


Reports the value of the named variable. Corresponds to the use of a colon (:) 
preceding a word. The input must be the name of an existing variable. See 
make. 

Example: 


make "age 10 
show thing "age 









10 

show :age 

10 


timerl Reporter/No inputs 

timer2 

timer3 

timer4 


Reports the value of the specified timer, in tenths of a second. The value 
represents the time elapsed since the program started up or since the timer 
was reset by a resett command. See resettl, resett2, resett3, and resett4. 

Examples: 

show timerl 

43242 

resettl show timerl 

0 

waituntil [timerl > 120] startsample 


to Special word 


Starts a procedure definition. See end. 
Example (on the Procedures page): 

to conveyor 

end 


tone valid-numberl valid-number2 Command/2 inputs 


Produces a sound with a pitch specified by the first input which lasts for a 
duration specified by the second input. The frequency is in MIDI values (see 
table below) and the duration is in tenths of a second. The first input must be a 
number between 1 and 127, and the second input between 0 and 327. 
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MIDI values 



A 

A# 

B 

c 

C# 

D 

D# 

E 

F 

F# 

G 

G# 

Interval 1 





1 

2 

3 

4 

5 

6 

7 

8 

Interval 2 

9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 

Interval 3 

21 

22 

23 

24 

25 

26 

27 

28 

29 

30 

31 

32 

Interval 4 

33 

34 

35 

36 

37 

38 

39 

40 

41 

42 

43 

44 

Interval 5 

45 

46 

47 

48 

49 

50 

51 

52 

53 

54 

55 

56 

Interval 6 

57 

58 

59 

60 

61 

62 

63 

64 

65 

66 

67 

68 

Interval 7 

69 

70 

71 

72 

73 

74 

75 

76 

77 

78 

79 

80 

Interval 8 

81 

82 

83 

84 

85 

86 

87 

88 

89 

90 

91 

92 

Interval 9 

93 

94 

95 

96 

97 

98 

99 

100 

101 

102 

103 

104 

Interval 10 

105 

106 

107 

108 

109 

110 

111 

112 

113 

114 

115 

116 

Interval 11 

117 

118 

119 

120 

121 

122 

123 

124 

125 

126 

127 


Examples: 













tone 60 

10 





Plays middle C. 





repeat 5 

[tone 60 

10 

wait 

5] 









toollist 


Reporter/No inputs 


Reports a list containing the names of all the tools procedures loaded with 
loadtools. Tools procedures work like normal procedures but are invisible. They 
remain in the computer’s memory even when going from project to project. 

Use cleartools to delete tools procedures. See cleartools and loadtools. 

Example: 

show toollist 

[arxnright armleft armup armdown] 


top Command/No inputs 


Moves the cursor to the beginning of the text in the current text box or on the 
Procedures page. 
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Example: 

tto "textl 
pr "hello 
ct 
top 

pr "there 


touch# 


Reporter/No inputs 
(suffix needed) 


The actual name of this primitive can be touch 1 to touch4. The value reported 
by this primitive depends on the mode that is set in its dialog box. The default 
mode for a touch sensor is Boolean. See raw and counter. 


Setting in the dialog box: Values reported: 

boolean The state of the touch sensor (true if 

pressed, false otherwise). 

counter The number of times the sensor has been 

pressed and released since last reset. 

The dialog box for a touch sensor can be used to reset the counter to 0 and 
designate the type of reading the sensor should perform (Boolean or Counter). 

Examples: 

show touch2 

12 The sensor is set in Counter mode. 

Set the touch sensor in Boolean mode and press the sensor switch to start 
sampling. 

launch [waituntil [touch2] startsample] 


true 


Special word 


True is a special word used by many primitives such as if, and, ifelse, and not. 
Many other primitives or logical expressions report true or false; for example, 
member?, =, number?, and empty? 
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Example: 

show touch2 

true 

if touch2 [do.this] 


type word-or-list 


Command/1 input 


Prints the word or list in the Command Center, without a carriage return 
following (the cursor does not move to the next line). See print, insert, and 
show. 

Example: 

type" go Press Return or Enter. 

go Go is displayed. Press Return or Enter again. 

Go is executed (if it is a defined procedure). 


V 


value 


Reporter/No inputs 


Reports the value of the current slider. Typing the name of the slider has the 
same effect. See setvalue. 

Examples: 

talkto "speed 
show value 

5 

setvalue value + 1 
show speed 

6 








w 


wait number 

Command/1 input 


Causes a pause in the execution of a program. The time is measured in tenths 
of a second. 

Examples: 

repeat 5 [on wait 5 off] 
repeat 5 [tone 60 10 wait 5] 


waituntil true-or-false-list-to-run Command/1 input 


Tells Control Lab to wait until true-or-false-list-to-run is true before following 
another instruction. The input must be an instruction list that reports either 
true or false when it is run. See wait. 

Examples: 

waituntil [not touch2] 
waituntil [touch2] startsample 


word word-or-listl word-or-list2 Reporter/2 inputs 

(word word-or-listl word-or-list2 word-or-list3...) 

Many inputs when parentheses 
are used. 


Combines its inputs into one word and reports the word. Can be used to make 
a list into a word. See list and sentence. 

Examples: 

show word "hello "there 
hellothere 

show (word "hello char 32 "there) 

hello there 

show word "light 5 

light5 
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word? word-or-list 

Reporter/1 input 


Reports true if the input is a word; otherwise, it reports false. See word. 


Examples: 

show word? "I hello there I 

true 

show word? 3.5 

true 

show word? [] 

false 






Section 3: Appendices 



This section contains four appendices covering technical issues and special 
LEGO DACTA® Control Lab software features. 

Appendix 1, Control Lab Primitives and Special Words, lists the names of all the 
Control Lab primitives. They are listed in groups according to functions: 
graphics, word processing, and so on. 

Appendix 2, Shapes, describes the pre-defined shapes for buttons, sliders, and 
picture boxes. 

Appendix 3, Creating Variables, explains how to make global and local 
variables. 

Appendix 4, Control Lab Messages, gives a list of error messages that Control 
Lab can display; what is likely to be the cause of the error; and how to solve the 
problem. 

Appendix 5, Glossary of Control Lab and Computer Terms, is a list of terms used 
in the Control Lab documentation. 
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Appendix 1: Control Lab Primitives and Special Words 


Control Lab Elements 

ask 

elementlist 
talkto (tto) 

Page Elements 

bg 

create 

hideframe 

hidename 

pos 

remove 

setbg 

setname 

setpos 

setsize 

showframe 

showname 

size 

Text Boxes and 
Procedures Page 

bottom 

cleartext (ct) 

font 

fontsize 

gettext 

insert 

loadtext 

print (pr) 

setfont 

setfontsize 

setstyle 

settc 

style 

tc 

top 

Monitor Boxes 

activate 

deactivate 

setmonfunction 


Buttons 

setbuttonmode 

setofffunction 

setonfunction 

Shapes and 
Picture Boxes 

eg 

closeshape 

delshape 

drawingpos 

lineto 

loadpict 

moveto 

openshape 

renameshape 

resetpicture 

setcolor 

setpenpat 

setpenwidth 

setshape 

setwallpaper 

shape 

shapelist 

Sliders 

limits 

setlimits 

setsliderfunction 

setvalue 

value 

Graph Boxes 

clearcurve 

clearcurves 

datalist 

hidescales 

loaddata 

sampling? 

savedata 

setcurvefunction 

setdata 

setinterval 

setxorg 


setyaxis 

showscales 

startsample 

stopsample 

Words and Lists 

ascii 

butfirst (bf) 

butlast (bl) 

char 

count 

empty? 

equal? 

first 

fput 

identical? 

insertitem 

item 

itempos 

last 

list 

list? 

lput 

member? 

number? 

parse 

removeitem 

replaceitem 

sentence (se) 

show 

type 

word 

word? 

Project Management 
and Workspace 

clearpage (cp) 
clearproject 
closeproject 
erpage 
getpage (gp) 
loadprocs 
loadshapes 
namepage (np) 


newpage 

newproject 

recycle 

space 

Screen Management 

cc 

hidecc 

hidetools 

showee 

showtools 

Variables 

clearname 

clearnames 

local 

make 

name 

name? 

printnames 

thing 

Disk Management 

chdir (cd) 

currentdir 

erasefile (erfile) 

erproject 

getproject 

nameproject 

pagelist 

prefix 

projectlist 

restoreproject 

saveproject 

savetext 

setprefix 

textlist 

Printing 

printpage 

printproject 

printtext 






Control and Logic 

and 

carefully 

errormessage 

forever 

if 

ifelse 

launch 

not 

or 

output (op) 

repeat 

run 

stop 

stopall 

stopme 

waituntil 

Mathematics 

+ 


/ 

> 

< 

>= 

<= 

<> 

abs 

arctan 

average 

cos 

difference 

greater? 

int 

less? 

max 

min 

minus 

product 

quotient 

random 

remainder 


rerandom 

round 

setcomma 

setpoint 

sin 

sqrt 

sum 

tan 

Sound and lime 

resettl 

resett2 

resett3 

resett4 

timer 1 

timer2 

timer3 

timer4 

tone 

wait 

Tools 

cleartools 

loadtools 

toollist 

Special Words 

end 

false 

startup 

to 

true 

Input and Sensors 

(See also 

System-Generated 

Primitives) 

angle 

boolean 

Celsius 

counter 

fahrenheit 

key? 

mousebutton? 


mousepos 

option? 

percent 

raw 

readchar 

resetcounter 

resetrotation 

rotation 

setdd 

shift? 

Controlling LEGO® 
Elements 

alloff (ao) 
flash 
off 
on 

onfor 

power 

rd 

setleft 

setpower 

setright 

System Primitives 

fontlist 

setpreference 

System-Generated 

Primitives 

angle# 

light# 

temp# 

touch# 
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Appendix 2: Shapes 


Buttons, sliders, and picture boxes are always created in their default shapes. 

To change their shapes, use the popup menu in the dialog box of the 
corresponding element, or use the set shape command. For example: 

talkto "buttonl 

setshape "on 

setshape "Heft arrow I 

Note that shape names often contain spaces. Use the vertical bars (I) to enclose 
the two words. 

Each type of element except graph and monitor boxes has its own shapes list. 
For example, if the current element is a button, the setshape input can only be 
the name of a button shape. If you use the name of a slider shape or a picture 
box shape, LEGO DACTA® Control Lab will display an error message. 


Button Shapes 

Name Design 

Rotate Counterclockwise 



Up 



Name 


Rotate Clockwise 


Down 


Left 


Slide Switch 


On Button 


Go To First Page 



Right 


Light Switch 


Off Button 



Design 

25 

IT 

~Off 





























Name 


Design 


Name 


Design 



Print Project 


Back 


Play 


Stop 


Reverse 


Left Slider 


Bottom Slider 


Default Button 



Print Page 


Forward 


Record 


Pause 



Right Slider 


Top Slider 


❖ 


O 



Slider Shapes 

Name Design Name 



Design 
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Name 


Design 


Name 


Design 



Pre-defined Shapes for Picture Boxes 


Name 


Name 


Empty Picture 


pictl 




Lamp 



Sound 
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Name 


Design 


Name 


Design 


Dark LED 


Motor Icon 


Lamp Icon 


LEGO Boy 


Touch 


Light 


Small Motor 


Interface 




Green LED 







Sound Icon 



LEGO Girl 


Temperature 


Angle 






ft 



P.T.V.V.'.'.V.V. 1 



Small Lamp 

m 

Small Sound 

s 



3.7 






















































































































Buttons and 
sliders can 
only have 
pre-defined 
shapes. 

New Shapes for Picture Boxes 

There are two ways to create a new shape for picture boxes: 

1) Use LEGO DACTA® Control Lab commands to create it on the project page. 

2) Develop a picture shape in another application and place on a Control Lab 
project page. 

Use the 

renameshape 

command to 
give the shape 
a more descrip¬ 
tive name. 

Creating a Picture Shape on a Project Page 

The openshape command creates a new shape by opening the shape in the 
current picture box for modification. The commands lineto, moveto, 
setpenwidth, setcolor and setpenpat can be used to trace lines in the new 
shape. After the shape is closed with closeshape, the new shape is part of the 
list of available shapes. 

Developing a Picture Shape and Placing on a Project Page: Macintosh 

You can copy and paste a picture from another application into Control Lab 
projects if the picture is saved as a .PICT file. 

Copy the picture into the Macintosh clipboard memory (2£-C). 

Open a Control Lab project. Select from the Pages menu the project page on 
which you wish to place the new picture. 

Paste the picture onto the Control Lab project page (K-V). 

A new picture box with the new picture shape is added to the project page. The 
new shape is also given a default name (such as shapel) and is added to the 
Shapes popup menu in the picture dialog box. 

The command 
delshape 

removes user- 
defined shapes 
from the shapes 
popup menu in 
both the 

Macintosh and 
MS-DOS ver¬ 
sions of Control 

Lab software. 

Developing a Picture Shape and Placing on a Project Page: MS-DOS 

You can load a picture from another application into Control Lab projects if the 
picture is saved in a .PCX format. 

Open a Control Lab project. Select from the Pages menu the project page on 
which you wish to place the new picture. 

Type loadpict fLlename.pcx in the Command Center. 

A new picture box with the new picture shape is added to the project page. The 
new shape is also given a default name (such as shapel) and is added to the 
Shapes popup menu in the picture dialog box. 


3.8 





Appendix 3: Creating Variables 



LEGO DACTA® Control Lab distinguishes between two types of variables, global 
and local. 


A global variable is one that stays in memory when no procedure is running 
and even when pages are changed. You can create a global variable using the 
make or name command. The two commands generally function the same. 
Both require two inputs: the name of the variable you are creating and the 
word or list of words at which you want to set the value; however, they expect 
the inputs in different orders. Make expects the name of the variable first, then 
the value; name expects the value first, then the name of the variable. 


make "height 150 
show :height 

150 


Use make to define a variable with a value. 

Use show to display the value. 

The computer shows the value of the variable height. 


name [5 78] "codelist Use name to assign a value to a variable name, 
show : code list Use show to display the value. 

[5 78] The computer shows the value of the variable. 

codelist 


Notice that the quote mark indicates you are referring to the name of the 
variable and the colon indicates you are referring to the value of the variable. 


show "height 

[height] 

show :height 

150 


Display the word height. 

The computer responds. 

Display the value of the variable height. 
The computer responds. 


If you make or name a global variable in the Command Center, it will not be 
saved after the computer is turned off. To save the definition of a global 
variable, create a procedure. Then, the next time you open the project, you can 
run one procedure to define all the global variables. 


to set.variables 
make "height 150 

make "width 200 

make "colors [red yellow blue] 

end 


Create a variable height and set its 
value to 150. 

Create a variable width and set its 
value to 200. 

Create a variable colors and set its 
value to the list. 


To clear global variables from memory, type clearnames. 
show : height Display the value of height. 

150 The computer responds. 
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clearnames Clear all global values from memory, 

show : height Display the value of height. 

height has no value The computer responds. 

Local variables stay in memory only while a procedure is running. You can 
create a local variable when you define a procedure. 

to set. speed : level Define a procedure with one local variable, 
talkto "motora Address a motor in port A. 

setpower : level Set the motor power to the level entered by the user, 

onfor 50 Turn on the motor for 5 seconds. 

end 

When you run your procedure, enter the value for the variable immediately 
following the procedure. 

set. speed 3 Run the procedure set. speed and set the local 

variable level to 3. 

After you run the procedure, the local variable is not in memory. 

show : level Display the value of level, 

level has not value The computer responds. 

If you wish to see the value of a local variable while a procedure is running, you 
can add the show command inside the procedure. 

to set.speed 
talkto "motora 
setpower :level 

show : level The new line displays the value of level before 

turning on the motor. 

onfor 50 
end 

You can create many global and local variables. To limit confusion, give each 
variable a meaningful name. 







Appendix 4: Control Lab Messages 

) in wrong place 

A parenthesis was used incorrectly - check that all parentheses are in matched 
pairs, with the same number of opening parentheses as closing ones. 

Can't divide by zero 

A number cannot be divided by zero. Check the divisor you used. Sometimes 
the divisor is not an explicit number. If the divisor is a variable or a slider, check 
its value. 

Can't find the Control Lab interface box 

Communication between the computer and the interface box was not 
established or is lost. Check the interface cable connection to the computer 
and the Preferences setting in the Control Lab File menu to make sure they are 
the same. See the Troubleshooting Help section of the Setup Guide and 
Introductory Explorations book for more ideas. 

Directory not found 

A setprefix or chdir command was directed to a directory that does not exist 
(probably because of a typing error in the pathname). Check the instruction 
and use currentdir or prefix to find out the name of the current directory. 

Disk or directory full 

There is no more room on the disk or in the current directory. Switch disks or 
directories. 

Disk or directory is locked 

The disk is locked or the directory is write-protected. Unlock the disk, or switch 
disks or directories. 

File is locked 

The name of a locked file was given as input to erasefile. Use the operating 
system to unlock the file. 

I can't start a new process 

The amount of memory available does not allow starting a new process. Use 
stopall to stop all processes and launch only those which are relevant to your 
project. 

I don't know bow to name 

Control Lab tried to run a word that is neither the name of a primitive, a tool, a 
procedure, nor the name of a reporting element (the names of text boxes and 
sliders, for example, report a value) in the project. Sometimes an instruction 
can contain an invalid space (Option-space). An Option-space is a special 
character that looks like a space but isn’t one. Delete spaces and retype them. 
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I don't know what to do with name 

A line (typed in the Command Center or used in a procedure) began with a 
reporter. Every instruction must begin with a command. 

I'm having trouble with the disk or drive 

Check that there is a disk in the drive and that all connections are secure. 

Minimum height of a monitor is 5 

An invalid input was given to setsize or create. MS-DOS note: the minimum 
height is 13. 

Minimum size of a graph is [180135] 

Invalid values were given to setsize or create. MS-DOS note: the minimum 
size is [191122]. 


Missing [ 

Missing ] 

Check that all square brackets on the Procedures page are in matched pairs, 
with the same number of opening brackets as closing ones. Any procedure 
following the error on the page is not defined. 

Motor in use 

A command was given to a motor that is already busy. This problem can only 
occur when a motor is turned on by a launch command. 

Name can only be used in a procedure 

Stop or output was used in the Command Center. These commands are used 
to stop procedures, so they can only be used inside procedures. 

Name cannot be resized 

Some page elements can be resized, some cannot. Select the element. If it has 
black “handles” at its corners, it is resizable. If the handles are gray, it is not 
resizable. Buttons are resizable only when they have the default button shape. 

Name didn't report anything to name 

A primitive or procedure requiring an input did not get one from the primitive 
or procedure following it. 

Name does not like name as input 

Some primitives require a certain type of input; for example, math operations 
require numbers as input. Check the alphabetic listing Section 2, Listing of 
Primitives for specific requirements. 





Name has no value 

The variable name was used, but had not previously been assigned a value. 
Verify that the name used was correct (pr intnames prints the variables in 
memory). A variable is given a value by naming it on the input line of a 
procedure or by using the make or name commands. 

Name is a reserved shape 

Shapes provided with the system (e.g., button shapes) cannot be modified or 
deleted. Their names cannot be used as input to delshape and openshape. 

Name is already sampling 

A graph box related command was used on a graph box that is already 
sampling. Use stopsample first. 

Name is already used 

A procedure or an element was created using a name that LEGO DACTA® 
Control Lab already uses for a primitive or an element (textl, setr ight, etc.). 
Primitive names and the names of reporting elements (e.g., text box or slider) 
cannot be used for your own procedures. 

Name is nnt a valid primitive nn this page 

Some primitives only work when a project page is showing. For example, 
namepage does not work if the Setup page is showing. Go to a project page 
before running the command. 

Name is not true or false 

Namewas used as an input to a primitive requiring true or false as input 
(e.g., if, if else, and, or, and not). 

Name needs an open project 

Some commands, like create, cannot be executed if there is not a current 
project. Choose Open or New Project from the File menu. 

Name needs an open shape 

A shape-modifying command, such as lineto, was given while there was no 
currently opened shape. Use openshape before using this command. 

Name needs more inputs 

Namewas not given the inputs it requires. Check the primitive or the 
procedure definition to find what inputs name requires. 
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Name not found 

Control Lab was unable to find the requested item. Check the items in the list. 

No Button found for name 

There is no current button for the specific command (e.g., setonfunction) 
that was given. Create a button before using this command or click on the 
button if there is one on the page (this makes it current). 

No element found for name 

Many LEGO DACTA® Control Lab commands address more than one type of 
element. Set font, for example, addresses text boxes and monitor boxes. 
Create the element that is needed before using the command addressing it or 
click on the element if there is one on the page (this makes it current). 

No Graph box found for name 

There is no current graph box for the specific command (e.g., startsample) 
that was given. Create a graph box before using this command or click on the 
graph box if there is one on the page (this makes it current). 

No Monitor box found for name 

There is no current monitor box for the specific command (e.g., 
setmonfunction) that was given. Create a monitor box before using this 
command or click on the monitor box if there is one on the page (this makes it 
current). 

No more room for text 

An instruction to paste or load caused the total number of characters in a text 
box or on the Procedures page to exceed the maximum that the system will 
allow. Use a different text box or split your project. 

No Picture box found for name 

There is no picture box for the specific command (e.g., openshape) that was 
given. Create a picture box before using this command or click on the picture 
box if there is one on the page (this makes it current). 

No Slider found for name 

There is no current slider for the specific command (e.g., setvalue) that was 
given. Create a slider before using this command or click on the slider if there is 
one on the page (this makes it current). 

No Text box found for name 

There is no text box for the specific command (e.g., top) that was given. Create 
a text box before using this command or click on the text box if there is one on 
the page (this makes it current). 





Number too big 

You tried to use a number that is greater than what the system can manipulate. 
The cause of the error can be a number that you typed or the result of an 
operation. If variables are used, check their values. 

Only one shape may be opened at a time 

An openshape command was given while there was already a shape opened. 
Use closeshape before opening a new one. 

Out of space 

There is no free memory left. This message can occur when defining 
procedures or loading text. If this message occurs, leave the project (to save 
your procedures and graphics), and on a blank page in a new project, free some 
memory (clearnames removes variables from memory, and cleartools 
removes tools procedures). Use the recycle command to increase the amount 
of available space. 

Page name already exists 

The name of an existing page in the project was given to namepage. Use a 
different name. 

Pathname must have less than 255 characters 

A pathname must have less than 255 characters. The name of a project is just 
the last part of a pathname. A full pathname is the name of the hard disk plus 
the names of all embedded directories (folders) that lead to the current 
directory. MS-DOS note: the pathname must have less than 64 characters. 

Please name this project 

The project that is displayed needs a name before it can be saved. If you want to 
keep the project, use nameproj ect to name it; if not, use clearpro j ect to 
clear the project before leaving it. 

Shape name is already in use by name 

You have been trying to delete a shape that is already used in a picture box. 
Delete the picture box before deleting the shape. 

String too long 

A string can only contain up to 32,768 characters. 
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Stack overflow 

The portion of memory used to run recursive procedures has been entirely 
used. This can happen in a project that is not full. Check if your procedure has 
many instructions following the recursive line. 

There's already a file or project named name 

The name of an existing file was given to namepro j ect, savedata, or 
savetext. Use a different name. 

There's no file named name 

The last file command received, as input, the name of a file that does not exist 
in the current folder (directory). Use projectlist or textlist to find the 
names of projects and text files. Choose Open from the File menu to look at the 
list or change the current folder (directory). 

There's no project named name 

The last project command received, as input, the name of a project that does 
not exist in the current folder (directory). Use pro j ect list to find the names 
of projects. Choose Open from the File menu to look at the list or change the 
current folder (directory). 

Too few items in name 

Name does not have the required number of components. For instance, the 
fifth component of a list was requested (item 5), but the list contains only four 
components. 

Too much inside ()'s 

Parentheses were incorrectly used. For example, there are too many 
parentheses inside other parentheses. Simplify the instruction. 

Wrong file format for loaddata 

Loaddata loads a plain text file, if it has the appropriate format. Such a file 
can be made by a savedata or a savetext command, or from a different 
application. See the description of savedata for a description of the 
file format. 

Wrong file type (or name 

Some Control Lab commands apply to certain types of files. Loadt ext , for 
example, cannot use a project name as input. 




Appendix 5: Glossary of Control Lab and Computer Terms 



ASCII 

American Standard Code for Information Interchange. A code which 
represents characters numerically. 

boolean 

A boolean value is either true or false. 

brackets [ ] 

Characters used to surround lists. 

carriage return 

A character which causes the cursor to move to the first position on the next 
line (ASCII character 13). 

clicking 

Pressing and releasing the mouse button once. 

Clipboard buffer 

An area of memory for temporary storage of data that has been cut or copied. 
The contents of the Clipboard buffer can be pasted. 

command 

A word that tells LEGO DACTA® Control Lab to do something. All Control Lab 
instructions begin with a command. 

Command Center 

The area of the screen where instructions are typed. It is not part of the page. 
Anything typed in the Command Center will be run as an instruction. 

component 

An element of a word or list. The components of a list can be words or other 
lists; the components of a word are characters. 

conditional 

An expression which causes Control Lab to do one thing or another, depending 
on whether a condition is met or not. if and if else are used to build 
conditional expressions. 

double-clicking 

Pressing the mouse button twice in the same area. 
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dragging 

Pressing the mouse button, and, while holding it down, moving the mouse to a 
different area of the screen. 

element 

A component of a LEGO DACTA® Control Lab project. Elements can be page 
elements (e.g., text boxes, buttons, sliders) or Setup page elements (e.g., 
sensors, motors). 

empty list 

A list that has no components. You write the empty list as [ ]. 

empty word 

A word that has no characters. You write the empty word as". 

tile 

An organized collection of data that has been stored on disk. A saved Control 
Lab project is a kind of file that stores pages of text and graphics together. 

folder 

A file or directory containing information on other files on the disk: their 
names, sizes, and location. 

global variable 

A variable which stays in memory when no procedure is running and when 
pages are changed. In general, a variable is global when it is created with the 
make or name command. A variable which remains in memory only while a 
procedure is running is a local variable. For more information, see the listings 
for make and name and Appendix 3, Creating Variables. 

input 

The information that a primitive or procedure needs to run. It may be provided 
directly by putting a number, word, or list after a primitive that needs an input, 
or indirectly, by using a reporter. 

input port 

One of the eight ports (numbered 1 to 8) on the LEGO DACTA Serial Interface 
to which Control Lab sensors can be connected. These ports are used to receive 
information from the sensors. The input ports are graphically represented on 
the Setup page. 






interface box 

The connecting box through which the computer and the Control Lab 
components communicate. The LEGO DACTA Serial Interface. 

instruction 

A statement that starts with a command. The command may be followed by 
an input or any number of reporters. 

list 

One of the basic units for handling information. A list begins and ends with 
brackets and may be composed of words, numbers, or lists, or a combination 
of the three. 

local variable 

A variable which is only in memory while a procedure is running. A variable 
can be made local by naming it on the title line of a procedure. A variable 
which stays in memory even when no procedures are running is a global 
variable. 

operation 

Another term that is used to refer to reporters (primitives or procedures which 
output something). 

output 

To pass a value to a preceding primitive or procedure in an instruction. A 
primitive or procedure which outputs something is called a reporter. 

output port 

One of eight ports (numbered A through H) on the LEGO DACTA® Serial 
Interface to which you can connect motors, lamps, or sound elements. Output 
ports are graphically represented on the Setup page. 

page 

One of several pages in a LEGO DACTA® Control Lab project. A page is used to 
run experiments and write reports. Elements such as text boxes, buttons, and 
sliders can be placed on a page. A Setup page and Procedures page are special 
pages within the project. 

parentheses () 

Characters which are used in instructions to group primitives or procedures 
in such a way as to control the sequence in which they are run. Parentheses can 
also be used with some primitives to extend the number of inputs they 
can accept. 
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parse 

The process of making a list out of a sequence of characters. 

pathname 

A pathname is a logical location in the hierarchy of the filing system. It 
includes the volume name, the name of the folders which contain the file and 
the file name. 

port 

One of the electric systems connectors on the LEGO DACTA® Serial Interface to 
which you can connect the connecting leads. The interface box is graphically 
represented on the Setup page. Icons of LEGO® elements can be placed on the 
ports. Input ports are used to receive information about the sensors. 

prefix 

The description of the current pathname. Setting a prefix allows the user to 
specify only the file name instead of the full pathname when accessing files. 

primitive 

A word that is built into LEGO DACTA Control Lab and represents a process or 
function that Control Lab can run. 

procedure 

An instruction or series of instructions that has a name. 

Procedures page 

The page in a Control Lab project on which procedures are defined, edited, and 
stored. 

quotation mark 

A special character which marks the beginning of a word. A quotation mark is 
essential if a word is to be used as an input to a primitive or procedure; 
otherwise, Control Lab will try to interpret the word as a procedure to run. 

reporter 

A primitive or procedure which can report (output) a number, word or list to a 
preceding primitive or procedure. 

subprocedure 

A procedure which is run by another procedure; a procedure name which is 
used in the definition of another procedure. 






superprocedure 

A procedure which uses one or more other procedures in its definition; a 
procedure that runs another procedure. 

test reporter 

A primitive or procedure which reports true or false, depending on the 
result of a test. 

text file 

A file containing only text (ASCII characters). Also called an ASCII file. 

truncate 

To cut off the last item(s) of a word or number. 

word 

A sequence of one or more characters, treated as a unit. Numbers are words in 
LEGO DACTA® Control Lab. Words are separated by spaces. A word can contain 
a special character such as a space if the word and special character are 
enclosed with vertical bars (I). The process of converting a sequence of 
characters containing special characters into a list made of words is called 
parsing. 

workspace 

The part of the computer’s memory that is available to hold variables, Control 
Lab elements and procedures. 
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Index 


Special Characters 

[] brackets 3.15,3.20 

: colon 3.12 

, comma 2.75,2.86 

/ division sign 2.9 

= equal to sign 2.9 

>= greater than or equal to sign 
2.9 

> greater than sign 2.9 

<= less than or equal to sign 2.9 

< less than sign 2.10 
subtraction sign 2.8 

* multiplication sign 2.8 

< > not equal to sign 2.11 

() parentheses 3.14,3.22 

+ addition sign 2.8 

quotation mark 3.23 
I vertical bar 3.4 

A 

abs 2.11 
activate 2.11 
alloff(ao) 2.12 
and 2.12 
angle 2.13 
angle sensor 1.20 
angle# 2.13 
Apple menu 1.6 
arctan 2.14 
ascii 2.14 
ASCII 3.20 
ask 2.14 
average 2.15 

B 

bg 2.15 
boolean 2.15 
boolean 3.20 
bottom 2.16 
box 

graph 1.24 
monitor 1.34 
picture 1.32 


text 1.29 
brackets [ ] 3.20 
butfirst(bf) 2.16 
butlast(bl) 2.16 
button 
On 1.37 
On/Off 1.37 

C 

carefully 2.17 
carriage return 3.20 
cc 2.17 
Celsius 2.17 
eg 2.18 
char 2.18 
chdir(cd) 2.19 
clear 1.9 
clearcurve 2.19 
clearcurves 2.20 
clearname 2.20 
clearnames 2.20 
clearpage (cp) 2.21 
clearproject 2.21 
cleartext (ct) 2.21 
cleartools 2.22 
clicking 3.20 
Clipboard buffer 3.20 
closeproject 2.22 
closeshape 2.22 
colon: 3.12 
comma, 2.75,2.86 
command 3.20 
Command Center 3.20 
component 3.20 
conditional 3.20 

constant output port (test port) 1.12 

copy 1.8 

cos 2.22 

count 2.23 

counter 2.23 

create 2.23 

current element 1.40 

currentdir 2.24 

curve reader 1.28 

cut 1.8 




D 

datalist 2.24 
deactivate 2.25 
delshape 2.25 
difference 2.25 
division sign / 2.9 
double-clicking 3.20 
dragging 3.21 
drawingpos 2.26 

E 

Edit menu 1.8 
elementlist 2.26 
element 3.21 
empty list 3.21 
empty word 3.21 
empty? 2.27 
end 2.27 

equal to sign = 2.9 
equal? 2.27 
erasefile (erfile) 2.28 
erpage 2.28 
erproject 2.28 
errormessage 2.28 

F 

fahrenheit 2.29 
false 2.29 
file 3.21 
File menu 1.7 
first 2.30 
flash 2.30 
folder 3.21 
font 2.30 
fondist 2.31 
fontsize 2.31 
forever 2.31 
fput 2.31 
function 

monitor box 1.36 


G 

getpage (gp) 2.32 
getproject 2.32 
gettext 2.33 
global variable 3.21 
graph box 1.24 

greater than or equal to sign >= 2.9 
greater than sign > 2.9 
greater? 2.33 

H 

Help menu 1.10 
hidecc 2.33 
hideffame 2.34 
hidename 2.34 
hidescales 2.34 
hidetools 2.35 

I 

identical? 2.35 
if 2.35 
ifelse 2.36 
input port 3.21 
insert 2.36 
insertitem 2.36 
int 2.37 

interface box 3.21 
instruction 3.22 
interval 1.26 
item 2.37 
itempos 2.38 

K 

key? 2.39 

L 

lamp 1.14 
last 2.39 
launch 2.40 
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less than or equal to sign <= 2.9 
less than sign < 2.10 
; less? 2.40 
light sensor 1.19 
light# 2.40 
limits 2.41 
lineto 2.41 
; list 2.42 
list 3.22 
; list? 2.42 
loaddata 2.42 
loadpict 2.43 
loadprocs 2.42 
loadshapes 2.42 
loadtext 2.43 
loadtools 2.44 
local 2.44 
local variable 3.22 
lput 2.45 

M 

make 2.45 
■ max 2.46 
member? 2.46 

• menu 

Edit 1.8 
File 1.7 
Help 1.10 
Pages 1.9 
Windows 1.10 
: min 2.47 
minus 2.47 

• minus sign - 2.8 

• monitor box 1.34 

• motor 1.13 

: mousebutton? 2.47 
mousepos 2.48 
moveto 2.48 

• multiplication sign * 2.8 

N 

; name 2.49 
name? 2.49 


namepage (np) 2.49 
nameproject 2.50 
newpage 2.50 
newproject 2.50 
not 2.50 

not equal to sign < > 2.11 
number? 2.51 

0 

off 2.51 
on 2.51 
onfor 2.52 
openshape 2.52 
operation 3.22 
option? 2.52 
or 2.53 

output (op) 2.53 
output 3.22 
output port 3.22 

P 

page 3.22 

page element 1.12,3.21 
pagelist 2.54 
Pages menu 1.9 
parentheses () 3.14,3.22 
parse 2.54 
parse 3.22 
paste 1.8 
pathname 3.23 
percent 2.54 
picture box 1.32 
plus sign + 2.8 
port 3.23 

constant output (test) 1. 
input 1.16,3.21 
output 1.12,3.22 
pos 2.55 
power 2.55 
prefix 2.56 
prefix 3.23 
primitive 3.23 
primitives (help) 1.10 




print (pr) 2.56 
printing 1.7 
printnames 2.56 
printpage 2.57 
printproject 2.57 
printtext 2.57 
procedure 3.23 
Procedures page 3.23 
product 2.57 
project 1.4 
closing 1.7 
creating 1.7 
opening 1.7 
saving 1.7 
projectlist 2.58 

Q 

quotation mark" 3.23 
quotient 2.58 

R 

random 2.59 
raw 2.59 
rd 2.59 
readchar 2.60 
recycle 2.60 
remainder 2.60 
remove 2.61 
removeitem 2.61 
renameshape 2.61 
repeat 2.62 
replace 1.9 
replaceitem 2.62 
reporter 3.23 
rerandom 2.62 
resetcounter 2.63 
resetpicture 2.63 
resetrotation 2.63 
resettl 2.64 
restoreproject 2.64 
rotation 2.64 
round 2.65 
run 2.65 


S 

sampling 1.27 
sampling? 2.66 
savedata 2.66 
saveproject 2.67 
savetext 2.67 
search 1.9 
sensor 1.16 
sentence (se) 2.67 
setbg 2.68 

setbuttonmode 2.68 
setcolor 2.68 
setcomma 2.69 
setcurvefunction 2.69 
setdata 2.70 
setdd 2.70 
setfont 2.70 
setfontsize 2.71 
setinterval 2.71 
setleft 2.72 
setlimits 2.72 
setmonfunction 2.72 
setname 2.72 
setofffunction 2.73 
setonfunction 2.73 
setpenpat 2.73 
setpenwidth 2.74 
setpoint 2.74 
setpos 2.74 
setpower 2.75 
setpreferences 2.75 
setprefix 2.76 
setright 2.76 
setshape 2.76 
setsize 2.77 
setsliderfunction 2.77 
setstyle 2.77 
settc 2.78 
Setup page 1.11 
setvalue 2.78 
setwallpaper 2.78 
setxorg 2.79 
setyaxis 2.79 
shape 2.79 
shapelist 2.80 
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shift? 2.80 
show 2.80 
showcc 2.81 
showframe 2.81 
showname 2.81 
showscales 2.81 
showtools 2.82 
sin 2.82 
size 2.82 
slider 1.38 
sound element 1.15 
space 2.83 
spaces 2.1 
sqrt 2.83 
startsample 2.83 
startup 2.83 
stop 2.84 
stopall 2.84 
stopme 2.85 
stopsample 2.85 
style 2.85 
subprocedure 3.23 
superprocedure 3.23 
sum 2.86 


true 2.91 
truncate 3.24 
type 2.92 

U 

undo 1.8 

V 

value 2.92 
variable 3.12 
vertical bar I 3.4 

W 

wait 2.93 
waituntil 2.93 
wallpaper 2.78 
Windows menu 1.10 
word 2.93 
word 3.24 
word? 2.94 
workspace 3.24 


T 

talkto (tto) 2.86 
tan 2.87 
tc 2.87 
temp# 2.87 

temperature sensor 1.17 

test reporter 3.24 

textbox 1.29 

text file 3.24 

textlist 2.88 

thing 2.88 

timerl 2.89 

to 2.89 

tone 2.89 

toollist 2.90 

tools palette 1.22 

top 2.90 

touch sensor 1.18 
touch# 2.91 
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